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On first thought, it might seem strange that another book on the 8080 and 
Z-80 should appear at this time. Z-80 CPU cards generally became available 
in 1977 and the 8080 CPU is even older. But the Z-80 computer seems to 
become more popular with time. For example, the TRS-80 Model II an- 
nounced recently by Radio Shack, and Heath's H-89 both use the CPU. 
High-level languages such as Pascal, APL, BASIC, FORTRAN, and C are now 
run on the 8080 and Z-80. Furthermore, Microsoft has available a Z-80 CPU 
card that can be easily inserted into the Apple II computer. There should be 
an increasing interest in the 8080 and Z-80 CPUs in the coming years, and I 
believe, a great increase in the number of 8080 and Z-80 programmers. So, 
there is a growing need for a book that covers programming for the 8080 
and Z-80 assembly languages. 

The combination of 8080 and Z-80 programming concepts into a single 
work is quite natural. The Z-80 CPU is upward compatible from the 8080 
so that all commercially available 8080 software vdll run on the Z-80, 
Furthermore, 8080 assemblers, such as ASM provided with CP/M, can be 
used to create programs that will run on either an 8080 system or a Z-80 
system. 

The purpose of this book is twofold. First, 1 want to provide a single 
reference source for both 8080 and Z-80 assembly language programmers. 
The appendixes are designed with this goal in mind. They begin with the 
ASCII character set and a 64K memory map. These two appendixes are as 
useful to those using higher level languages as they are to assembly language 
programmers. 

The 8080 and Z-80 instruction sets are listed both alphabetically and 
numerically in the next four appendixes. This is followed by a cross refer- 
ence between the 8080 and the Z-80 mnemonics. An appendix describing 
each instruction in detail then follows. Common acronyms are identified 
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next in Appendix I, and some undocumented Z-80 instructions are dis- 
cussed in the final appendix. Collectively, the appendixes contain all of the 
reference material needed to write 8080 or Z-80 assembly language programs. 

The second purpose of this work is to demonstrate some useful tech- 
niques of assembly language programming. As an editor for Interface Age, I 
have seen numerous examples of inefficient or improper programming. 
General principles of assembly language programming are discussed in 
Chapters One through Five; specific programming examples are given in 
Chapters Five through Ten. The reader can actually assemble the programs 
and try them out. 

The organization and operation of the 8080 and Z-80 CPUs is covered 
in Chapter One. This includes a discussion of the general-purpose registers, 
the flag registers, logical operations, branching, double-register operations, 
rotation and shifting. The concepts of hexadecimal, octal, and binary num- 
bers, one's and two's complement arithmetic, and the use of logical opera- 
tions are presented in Chapter Two. 

Stack operations with PUSH, POP, CALL and RET commands and the 
passing of data between calling program and subroutine are given in Chapter 
Three. Chapter Four is devoted to input and output techniques, including 
an intermpt-dirven keyboard routine and a telephone transmission program. 
Assembler macros are discussed in Chapter Five. Examples show how to 
generate Z-80 instructions with an 8080 macro assembler, and how to emu- 
late Z-80 instructions on an 8080 CPU. 

The reader can develop a small, powerful monitor in Chapter Six using 
the top-down programming method. The monitor contains the usual com- 
mands of dump, load, and go. In addition, there is a memory test, a routine 
to search for one or two hex bytes or ASCII characters, a routine to replace 
all occurrences of one byte with another, and a routine to perform input 
and output through any port. 

In Chapter Seven the monitor is converted to Z-80 instructions and 
some additional features are added. Assembly -language subroutines for inter- 
converting between binary numbers and ASCII characters coded in one of 
the common number bases are given in Chapter Eight. These routines per- 
form all of the input and output through the system monitor developed in 
Chapter Six. Paper tape and magnetic tape routines are given in Chapter 
Nine. This method of data transfer is still very popular. I frequently am 
asked to read information on paper tape into our Z-80 computer so that it 
can be transmitted over the telephone line to our campus Dec-20 computer. 

CF/M is currently the most popular 8080/Z-80 operating system. 
Chapter Ten demonstrates how assembly language programs can utilize CP/M 
for all input and output by presenting three programs. One of these pro- 
grams allows the user to branch to any address from the system level. Never- 
theless, the use of CP/M is not the subject of this book. More information on 
the use of the CP/M operating system can be obtained from Using CP/M: A 
Self-Teaching Guide by Judi Fernandez and Ruth Ashley (John Wiley and 
Sons, Inc., 1980). 
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The assembly language programs in this book have all been assembled 
on an Altair 8800, with an Ithaca Z-80 CPU card and North Star double- 
density disks. The Lifeboat 2.0 version of CP/M was used as the operating 
system. The system monitor given in Chapter Six was additionally pro- 
grammed to run on a TRS-80 Model II, using a Lifeboart 2.2 version CP/M 
operating system. The alternate version of the input and output routines was 
used in this case. The Digital Research assembler MAC was used for the 8080 
instructions and the Microsoft assembler MACRO-80 was used for the Z-80 
code. All of the assembly listings have been reproduced directly from the 
original computer printouts. The manuscript was created and edited with 
MicroPro's Word-Master and formatted with Organic Software's Textwriter. 

Thanks to Heidi for typing the manuscript. Also, I should like to 
acknowledge the programmers at Microsoft, Digital Research, and Lifeboat 
Associates for the many things they have taught me about programming. 



Alan R. Miller 
June 1980 
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CHAPTER ONE 

Introduction 



There was a time when computers were gigantic machines containing racks 
upon racks of vacuum tubes. The invention of the transistor and the devel- 
opment of the integrated circuit (IC) changed all that. Today, it is possible 
to place tens of thousands of transistors on a single "chip" of silicon that is 
smaller than a quarter of an inch square. As a result of this technology, com- 
puters have become smaller and cheaper. 

Computers are commonly classified into three categories, based on size 
and capability. The largest are known as main frame computers, the middle- 
sized ones are called minicomputers, and the smallest are termed microcom- 
puters. A computer consists of three parts: the central processing unit 
(CPU), the main memory, and the peripherals. 

The CPU directs the activities of the computer by interpreting a set of 
instructions called operation codes, or op codes for short. These instructions 
are located in the main memory. The memory is also used for the storage 
of data. 





! main 


memoru 
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buss 




CPU ! 


<==========> 
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The CPU communicates with the user through such peripherals as the 
console, the printer, the disks, and so on. There are several electrical lines 
which are used to connect the CPU to the memory and to the peripherals. 
These lines are collectively known as the buss, or bus. 

The CPU contains a set of registers, which are internal memory locations 
used for data storage and manipulation. One of these is a special register 
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called the accumulator. It receives the results of certain CPU operations. 
The CPU will also have a status register to indicate the nature of a previous 
operation, e.g., whether the result is zero or negative or positive. It will also 
indicate whether a carry or a borrow occurred during the operation. 

Additional registers are used for auxiliary storage. They may contain 
general information such as a number that is about to be added to the 
accumulator. Alternately, a register may contain a number that refers to an 
address in the main memory. The value is called a memory pointer in this 
case. A special portion of main memory may be set aside for storing data. 
This area is called a stack. A special register called a stack pointer refers to 
this region. Another register, the program counter, tells the CPU where to 
find the next instruction in memory. 

Computer operations are controlled by a computer program. Those 
programs which are used to solve engineering and physics problems are called 
application programs. On the other hand, computer programs which deal 
with the operation of the computer's own peripherals are known as systems 
programs. 

The instruction set used by the CPU can be very large and difficult to 
use. Consequently, symbolic programming languages are commonly used 
instead. An application program may be written in a language such as BASIC, 
FORTRAN, or Pascal. This is called a source program. Then a separate pro- 
cessor program called a compiler or an interpreter is used to convert the 
user's source program into an object program that corresponds to the in- 
structions needed by the computer. 

A microcomputer's instruction set is relatively small compared to that 
of a larger computer. But even so, it is more convenient to mite systems 
programs in a symbohc language called assembly language, rather than in the 
machine language of the computer. A processor program, called an assem- 
bler, is then utihzed to translate the source program into the corresponding 
instructions of the computer. A major difference between assembly language 
and higher-level languages such as Pascal is that each line of an assembly 
language program represents one computer instruction. By contrast, one line 
of a Pascal source program might represent many computer instructions. 

A line of an assembly language program can contain up to four ele- 
ments: the label, the mnemonic, one or two operands, and a comment. 

Label Mnemonic Operand Comment 

start; call first {initialize data 

The label, which is usually terminated by a colon, is used to transfer control 
from one portion of the source program to another. The mnemonic repre- 
sents the desired CPU instruction. The operand might reference a CPU 
register, a memory location, or simply a constant. Finally, a comment, pre- 
ceded by a semicolon, can be used to explain the instruction. The comment, 
of course, is ignored by the assembler. 

The remainder of this chapter is devoted to a general discussion of some 
of the features of the 8080 and Z-80 CPUs. The complete instruction sets 
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for these CPUs are listed in the appendix. Specific details of each instruction 
are given in Appendix H. If you are already familiar with these instruction 
sets, then you might want to go on to the next chapter. 



THE 8080 CPU 



The 8080 CPU is an integrated circuit that has 40 pins (legs). It requires 
three power supply voltages-12 V, 5 V, and -5 V, and a two-phase clock 
that runs at 2 Megahertz (MHz). There is an accumulator, a flag register, six 
general-purpose registers, a stack pointer, and a program counter. The 
accumulator is sometimes known as register A. The flag register is usually 
called the PSW (the letters being an acronym for program status word). The 
general-purpose registers are designated by the letters B, C, D, E, H, and L. 
Sometimes the registers are paired into 16-bit double registers known as BC, 
DE, and HL. The accumulator and flag register may also be paired. There are 
78 different instruction types that produce a total of 245 different op codes. 
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Figure 1.1. The 8080 CPU registers. 



Some of the 8080 instructions explicitly refer to the accumulator or to 
one of the general-purpose registers (B, C, D, E, H, and L). 



mnemonic 


operand 


comment 


INR 


A 


5 increment accumulator 


ncR 


B 


pdecrement register B 


MOM 


HfB 


pmove contents of D to H 


MMI 


CfA 


5 put value of 4 into C 



When there are two operands, data moves from the right operand (the 
source) into the left operand (the destination). There are additional 8080 
commands that implicitly refer to the accumulator. 



mnemonic operand comment 

' rotate accumulator right 

5 rotate accumulator left 

? input a bate to A from port 

OUT 1 ; output a bate from A to port 1 

ANI 7 i logical AND with A and 7 

ORI 3 5 logical OR with A and 3 
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For certain 8-bit operations, the accumulator is implicitly one of the 
source registers and will contain the result of the operation. 

winemonic operand comnient 



ADD - C f add C to A 

SUB D } subtract D from A 

ANA H i losicsl AND of A with H 

ORA B I logical OH of A and B 



Other instructions refer to coupled pairs of 8-bit registers. These 
extended operations treat the BC, the DE, and the HL register pairs as 16-bit 
entities. Sometimes the stack pointer and program counter are included in 
these instructions. The X symbol in the mnemonic refers to these extended 
16-bit operations. 

mnemonic operand comment 

INX H I increment HL register pair 

OCX SP 1 decrenient stack pointer 

LXI DfO ! load zero into DE pair 

Additional instructions deal specifically with the HL register pair. The 
following two instructions move two bytes of data between memory and 
the HL double register. 

BineBonic operand comnient 

LHLD 3 ? addr 3? 4 to L and H 

SHLD 3 f LtH to addr 3> 4 

The LHLD instruction copies the value at memory location 3 into the L 
register and the value at location 4 into the H register. The SHLD operation 
reverses the process. 

The XCHG operation interchanges the 16-bit HL register pair with the 
16 -bit DE register pair. 
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The SPHL command copies the HL register into the stack pointer register. 
The PCHL instruction copies the HL register pair into the program counter 
register. 



INTRODUCTION 5 



There are several instructions that perform double-register addition. 
The number in one of the 16-bit registers is added to the number in HL. The 
sum appears in the HL register pair. 



DAD D 5 add DE to HL 

OAD SP f stack pointer + HL 



THE MEMORY REGISTER 

There is another 8-bit register for the 8080 that is not shown in Figure 1.1. 
It is located in main memory. The 16-bit address contained in HL defines 
the location of this memory register, i.e., HL is a memory pointer. The 
instruction 

MOV M»E f •ove E to memoru 

will copy the contents of register E into the memory location pointed to by 
the HL register pair. The instruction 

INR M ^ J increment nbeihorM 

will increment this byte in memory. 



THE FLAG REGISTER 



Four bits of the PSW register can be used to control program flow. The bits 
or flags are used in conjunction with conditional jump, conditional call, and 
conditional return instructions. We say that a flag is set if it has a value of 1 
or is reset if it has a value of zero. 

The CPU sets the sign flag (S) if the result of a previous operation is 
positive; the flag is reset if the result is negative. The CPU sets a second flag, 
the zero flag (Z), if the result is zero; it is reset if not zero. Athirdflag, the 
carry flag (C), is set if there is a carry on addition or borrow on subtraction; 
it is reset otherwise. A fourth flag, the parity flag (P), indicates the parity of 
the result. Parity is even if there is an even number of ones (or zeros) and 
odd otherwise. 



! P 



Figure 1.2. The PSW (flag) register. 



The use of the flag register can be demonstrated with a simple routine. 
Suppose that a group of instructions is to be executed eight times. The fol- 
lowing code will do this. 
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mi B»8 iput 8 into B 

LOOP? ... 

... 

DCR B f decrement B 

JNZ LOOP floop if not zero 



The B register is initialized to the value of 8. The DCR B instruction near 
the end of the loop decrements the B register each time the loop is executed. 
This will reset the zero flag on each of the first seven passes through the 
loop since B has not reached zero. The following conditional jump instruc- 
tion, JNZ LOOP, causes the CPU to return to the line labeled LOOP in 
this case. 

On the eighth pass through the loop the original value of 8 in the B 
register will have been decremented to zero. Now the zero flag will be set 
and the conditional jump instruction will not cause a branch. The instruction 
immediately following the jump will be executed instead. 



FLAGS AND ARITHMETIC OPERATIONS 



The results of addition and subtraction operations can be characterized from 
the PSW flags. Three of the flags are of interest here:'the carry flag, the zero 
flag, and the sign flag. If the sum of two numbers exceeds 255 (1 less than 2 
to the eighth power), then the result is too large to fit into the 8-bit accumu- 
lator. The carry flag will be set to reflect this overflow. During subtraction, 
the carry flag is set when a larger number is subtracted from a smaller one. 
In this case, the flag becomes an indication that borrowing has taken place. 

Sometimes all eight bits of a register or memory location are used to 
represent a number. This is then an unsigned number. At other times it is 
convenient to utilize only the low-order seven bits (bits 0-6) for the mag- 
nitude of a number. The remaining high-order bit (bit 7) is then used to 
indicate the sign. 

magnitude 



ni3^nitude 



sisn 



8 bits 
I I I I I ! I 



_ j _ I _ I _ I _ I . 
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7 bits 
1 I I I I 



7 6 



4 3 



1 



unsigned number 



signed number 



Numbers represented in this way are known as signed numbers. A in bit 7 
means that the number is positive and a 1 means that the number is negative. 
An 8-bit signed number can range in magnitude from ^128 to 127, whereas 
an unsigned 8-bit number can range from to 255. 

The sign flag is set after certain operations if the value of bit 7 is 1 and 
it is reset if bit 7 is 0. If the sum of two numbers is exactly 256, the result in 
the 8-bit accumulator will be a zero. This occurs because 256 is 1 greater 
than the largest 8-bit number (255). The zero flag will be set in this case. 
In addition, the carry flag will be set because there is an overflow. The parity 
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flag will be set, since there is an even number of ones. (Zero is an even num- 
ber.) Finally, the sign flag will be reset because bit 7 is a zero. 



FLAGS AND LOGICAL OPERATIONS 

In the case of arithmetic operations such as addition and subtraction, there 
can be a carry or borrow from one bit to another. But the logical operations 
AND, OR, and XOR (exclusive OR) operate on each bit separately; there is 
never a carry from one bit to the next. These logical operations, therefore, 
always reset the carry flag. The zero and parity flags, however, will be set or 
reset according to the result of the particular operation. We will discuss 
logical operations more fully in Chapter 2. 

A value in the accumulator can be compared to a value in another 
register or to the byte immediately following the instruction byte in mem- 
ory. The CPU performs the comparison by subtracting the value of the 
operand from the value in the accumulator. In the case of a regular subtrac- 
tion, the difference is placed in the accumulator. For example, the arithmetic 
instruction 

SUB C 

subtracts the value in register C from the accumulator and places the differ- 
ence into the accumulator. The logical comparison operation 

CMP C 

also subtracts the value in register C from the value in the accumulator. 
However, unlike the regular subtraction operation, the difference in this case 
is not actually saved. The flags, of course, will reflect the result of the opera- 
tion. If the value in C is equal to the value in the accumulator the difference 
between them will be zero. In this case the zero flag is set indicating the 
equality. The carry flag will be reset since there was no borrow during the 
subtraction. 

If the two values are not equal, then A is either larger or smaller. If A 
is larger, the comparison operation will reset the carry flag (and, of course, 
the zero flag). If A is smaller, then the carry flag will be set, because a larger 
number has been subtracted from a smaller one. Thus, if the carry flag has 
been set after a comparison, then the value originally in the accumulator 
must have been smaller than the value with which it was compared. 

The following instructions can be used to determine if the value in 
register C is less than, greater than, or equal to the value in the accumulator. 

CMP C i subtract A from C 

JZ ZERO 5 if A eousls C 

JC LESS f if A less thsn C 

• • • f if A arester than C 
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The comparison instruction is executed first. This operation subtracts the 
value of C from the value in the accumulator. If the two numbers are equal, 
then their difference is zero. In this case, the zero flag is set and the JZ 
instruction causes a branch to the label ZERO. Otherwise, the next instruc- 
tion is executed. Another possibiUty is that the value in C is greater than the 
value in the accumulator. The subtraction in this case requires a borrow so 
the carry (borrow) flag is set. The JC instruction then causes a branch to the 
label LESS. The last possibility is that the value in the accumulator is larger 
than that in register C. For this case, both the zero and the carry flags are 
reset, and the program continues. 



INCREMENT, DECREMENT, AND ROTATE INSTRUCTIONS 

The 8-bit increment and decrement instructions present an interesting case. 
Mathematically, the increment operation simply adds 1 to the current value 
in a register. Likewise, the decrement operation subtracts 1 from the present 
value. Thus, the two instructions 

INR A snd 
AIiI 1 

both increase the value in the accumulator by 1 and the operations 

DCR A and 
SUI 1 

both decrease the value in the accumulator by 1. The zero, parity, and sign 
flags correctly reflect the result in all cases. 

The carry flag, however, responds differently for the two cases. The 
flag correctly reflects the result of the operation in the case of addition, but 
it is unaffected in the case of an increment or decrement operation. Thus, if 
you need to increment or decrement a value without disturbing the carry 
flag, then you should use the INR or DCR instructions. On the other hand, 
if you need to know whether a carry or borrow occurred during an incre- 
ment or decrement, then use an add or subtract operation. 

The instructions following the label GETCH in Listing 6.1 (in Chapter 
6) are used to set ASCII characters from the console input buffer. As each 
character is obtained, the count of the remaining characters is decremented. 
When the count has been decremented past 0, then the routine is finished. 
Subtracting 1 from requires a borrow so the carry flag should be set. But 
since the regular decrement operation doesn't alter the carry flag, the sub- 
tract instruction must be used instead. 
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ROTATION OF BITS IN THE ACCUMULATOR 

There are four 8080 instructions that rotate the bits in the accumulator. The 
operations move each bit by one position. Two instructions rotate the bits 
to the right and two rotate them to the left. The right circular rotation 



RRC 



moves each bit one position to the right. The rightmost (low-order) bit is 
moved to the high-order bit and into the carry flag. 



I _ — I 1 1 1 1 1 1 1 



The left circular rotation 
RLC 

moves the bits the other way. 



j 1 1 1 1 j j 1 1 

sccumulator 



carra 



! 1 

I <■_. 
j j 

carry 



j j . 

<- <- 
— I — _ I . 



accumulator 



Each bit is moved one position to the left. The high-order bit goes to both 
the low-order bit and to the carry flag. ' 
The rotate accumulator right instruction 



RAR 



moves each bit one position to the right. But this time, the carry flag moves 
into the high-order bit and the low-order bit moves into the carry flag. 



! I j j I I 

! -> -> -> -> - 
I j I 1 I I 

accumulator 



The instruction 
RAL 



.(___! 



!- 

carry 



10 
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moves each bit one position to the left. The carry flag moves into the low- 
order bit and the high-order bit moves into the carry flag. 



!- ! ! < 
C3rra 

FLAGS AND DOUBLE-REGISTER OPERATIONS 

Double-register, or extended, operations involving HL, DE, and BC affect the 
flags very differently from the single-register operations. We saw that single- 
register increment and decrement operations did not alter the carry flag. The 
extended increment and decrement commands never alter any of the flags. 
This means that if a program is to loop until a double register has been 
decremented to zero, the following set of instructions will not work. 

loop: . . . 

t 4 « 

DCX H ? 16-bit decrement 

JNZ LOOP 5 if not zero 

The proper procedure is to compare the two 8-bit halves with each other. 
This can be done by moving one of the registers to the accumulator. 

HOV A,L 

Then the accumulator is compared to the other half by performing a logical 
OR. The result of this operation will set the zero flag only if both halves are 
zero. The complete operation looks like this. 

LOOP? . . . 

♦ * * 

DCX H ? 16-bit decrement 

MOV AtL ImovB L to A 

ORA H pOR with H 

JNZ LOOP J if not zero 

The double-register add instruction correctly sets the carry flag if there 
is an overflow from the 16 bits, but zero, parity, and sign flags are not 
altered. 



THE Z-80 CPU 

The Z-80 CPU is a 40-pin IC just Uke the 8080. All of the 8080 instructions 
are common to the Z-80, thus we say the Z-80 is upward compatible from 
the 8080. In general, any program that runs on an 8080 will also run on a 



I 1 1 I 1 I I 1 

j ! j j j j I j 

accumulator 
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Z-80. The one exception is that the 8080 parity flag is affected by arithmetic 
operations, while the Z-80 parity flag is not. Thus, one can use an 8080 
assembler to generate 8080 code on a Z-80. 

The Z-80 requires only a single 5-volt power supply and a single-phase 
clock that can run as fast as 6 MHz. There are 158 instruction types that 
give a very large number of total commands with all variations. These are 
given briefly in Appendixes E and F and in more detail in Appendix H. The 
Z-80 contains all of the 8080 general-purpose registers, plus an alternate set 
for easy interrupt processing. The alternate set is indicated with a prime 
symbol: A', B', and so on. Only one of the two general sets of registers can 
be used at any time, therefore, data cannot be transferred directly from one 
set to the other. There are also two 16-bit index registers called IX and lY, 
an 8-bit interrupt register (I), and an 8-bit refresh register (R). ' 



Primary registers 



Alternete reaisters 





f 8 


bits 


! 8 


bits 


PSW 


A' ! 


8 


bits 


8 


bits 


PSW 


B 


! 8 


bits 


! 8 


bits 


c 


B' ! 


8 


bits 


8 


bits 


C 


D 


! 8 


bits 


i 8 


bits 


E 


D' ! 


8 


bits 


8 


bits 


E' 


H 


! 8 


bits 


! 8 


bits 


L 


H' ! 


8 


bits 


8 


bits 


L' 


SP 




16 


bits 


















PC 




16 


bits 



















Index 

Register X 
Index 

Register Y 



16 bits 
16 bits 



Interrupt 
Register I 

Refresh 
Register R 



8 bits 
8 bits 



Figure 1.3. The Z-80 CPU registers. 

An operand for an assembly -language instruction may consist of a value 
that is used directly, or it may refer to a location that contains the value. For 
example, the command 



LB 



A»6 



instructs the CPU to place the value of 6 into register A. Similarly, the 
instruction 



LD 



ArD 
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will move the contents of register D into register A. Alternately, the operand 
may be a pointer to another location. Thus the command 

will move the byte located at address 6 into the accumulator. Similarly, the 
instruction 

LD A»<HL) 

tells the CPU to move the byte pointed to by the HL register into the 
accumulator. The Z-80 mnemonics clearly differentiate a pointer by means 
of the parentheses, whereas the corresponding 8080 mnemonics do not make 
such a clear distinction. 



Z-80 RELATIVE JUMPS 

Computer instructions are generally executed in order, one after the other. 
But it is sometimes necessary to branch out of the normal sequence of state- 
ments. Branching statements can be classified as either conditional or uncon- 
ditional. An unconditional or absolute branch always causes the computer 
to execute instructions at a new location, out of the normal flow. Condi- 
tional branching, on the other hand, is based upon the condition of one of 
the flags. 

Programs utilizing the Z-80 instruction set can be significantly shorter 
than those written with 8080 operation codes, especially if the relative jump 
instructions are used. Relative jumps are performed by branching forward or 
backward relative to the present position. Absolute jumps, on the other 
hand, are made to a specific memory location. Furthermore, there are both 
unconditional and conditional branch instructions. The absolute, uncondi- 
tional jump op code and the conditional jump codes based on the state of 
the zero and parity flags are all three-byte instructions. 



Jp 


ADDRl 


f 


unconditional Jump 


Jp 


ZrADDR2 




Jump if zero flssi set 


Jp 


NZ>ADDR3 


f 


Jump if zero flaa reset 


Jp 


CsiADDR4 


f 


Jump if csrra flsa set 


Jp 


NCrADDRS 


f 


Jump if carry flsa reset 



The above instructions are available on both the 8080 and the Z-80 CPUs. 
In addition, the Z-80 has a relative, unconditional jump and five relative, 
conditional jumps. 

JR ADOR f unconditional Jump 

JR ZrADDR6 ? zero 

JR NZ»ADDR7 i not zero 

JR CfADDRS i carra 

JR NC»ADDR9 ? not carry 

DJNZ ADDRIO t decre Jump not zero 
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The relative jumps are only two bytes long as opposed to three bytes 
for the regular jumps, but the relative jump is limited to a displacement of 
less than 126 bytes forward or 128 bytes backward from the address of the 
current instruction. These numbers derive from the magnitude of the signed 
8-bit displacement. Bit 7 is used for the sign of the number. A in bit posi- 
tion 7 means a forward or positive displacement, a 1 in this bit position 
means a backward or negative displacement. The remaining seven bits are 
used for the magnitude of the jump. 

Absolute jumps are specified with a 16-bit address that gives the new 
location. Relative jumps on the other hand are position-independent. The 
resulting code can be placed anywhere in memory. The last operation above, 
DJNZ, is a combination of two instructions. The B register is decremented. 
If the result is not zero, then there is a relative jump to the given argument 
ADDRIO. This two-byte instruction requires four bytes on an 8080 ciPU. 



Z-80 DOUBLE-REGISTER OPERATIONS 

While some of the Z-80 instructions appear to be shorter than their 8080 
counterparts, they may not actually reduce the program size. Suppose, for 
example, that we want to move a block of data from one memory location 
to another. There is a single Z-80 instruction for accomplishing this task. 
The problem is that no verification is performed during the move. Thus, if 
there were no memory at the new location, or if the memory were defective, 
this fact would not immediately be discovered. If you want to check each 
location as the data are moved, then the Z-80 block-move instruction cannot 
be used. 

A better way to move data is to define the beginning of the original 
memory block with HL and the end with DE. The BC register defines the 
beginning of the new block. We can work our way through the original block 
by incrementing HL and BC at each step along the way. 

The end of the block can be detected when HL exceeds DE. We sub- 
tract the two 16-bit registers and observe the carry flag. The HL register pair 
will initially be less than the DE pair. Therefore, if we subtract DE from HL, 
we will set the carry (borrow) flag. 

Eventually, the number in the HL register will equal the value in the 
DE pair. This time, the subtraction will not set the carry flag and the task 
will be completed. Since the 8080 doesn't have a 16-bit subtract instruc- 
tion, the routine might look like this. 



LOOPJ ... 5 8080 version 

move' P,,L f GET L 

SUB E ? SUBTRACT E 

MOV AfH } GET H 

SBB n J SUBTRACT D AND BORROW 

JC LOOP ) IF NOT DONE 

RET ; DONE 
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As long as HL is less than DE, the subtraction will set the carry flag and the 
loop will be repeated. But as soon as HL equals DE, the carry flag will be 
reset and the subroutine is finished. 

The Z-80 has a 16-bit subtract instruction that can simplify the opera- 
tion. But since the result of the subtraction is placed in the HL register pair 
rather than in the accumulator, the data originally present in HL will have to 
be saved somewhere else, say, on the stack. The Z-80 code is: 



LOOP} 



OR 

PUSH 

SBC 

POP 

JR 

RET 



A 

HL 

HL»DE 
HL 

C»LOOP 



Z-80 version 
RESET CARRY 
SAME HL ON STACK 
SUBTRACT DE FROM HL 
RESTORE ORIGINAL HL PAIR 
IF NOT DONE 



The necessary Z-80 instructions require just as many bytes as the corre- 
sponding 8080 code. And if the carry flag on the Z-80 has not been reset by 
a previous instruction, it will have to be reset at the beginning with a logical 
OR instruction. This latter problem occurs because the Z-80 16-bit subtrac- 
tion includes the carry flag in its calculations. 



Z-80 INPUT AND OUTPUT (I/O) INSTRUCTIONS 

A useful pair of Z-80 instructions deals with input and output, i.e., the 
transfer of data between the CPU and peripherals such as the console, the 
printer, and the disk. The 8080 can only input and output data from the 
accumulator, and the address of the peripheral device must immediately 
follow the IN or OUT instruction in memory. 

OUT 10 
IN 11 

This usually means that for read-only memory (ROM), there must be sepa- 
rate input and output routines for each peripheral. 

In contrast, the Z-80 can input or output a byte from any of the 
general-purpose registers when the peripheral address is in the C register. 
In this case, it may be possible to use a single set of I/O routines for all 
peripherals. This approach is discussed more fully in Chapter 4. 



SHIFTING BITS 

The Z-80 CPU extends the four 8080 rotate instructions to the general- 
purpose registers B, C, D, E, H, and L. The memory byte referenced by HL, 
IX, and lY is also included. 

The Z-80 instruction set includes three shift operations. Shifts are 
similar to rotations sincQ each bit moves one position and the bit that is 
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shifted out of the register is moved into the carry flag. The difference is in 
the bit that is shifted into the register. 
The arithmetic shift left 



SLA 



shifts all bits to the left. A zero bit moves into the low-order bit. 



I 1 

! ! 
I j 

csrry 



I 1 . 

-<- <- 
I I .. 



. I ■ 



accumulator 



The operation doubles the original 8-bit value. This operation can be per- 
formed on the accumulator of an 8080 by using an 

ADD A 

instruction. 

A logical shift right 

SHL 

is the inverse of the arithmetic shift left operation. Each bit shifts one posi- 
tion to the right. A zero bit is shifted into the high-order position. 



. j ( _. 

-> -> 
. I 1 _. 



- ! — 
-.> 
- 1 — 



3ccuiriul3tor 



1 

I 



carra 



This operation halves the original 8-bit value. The carry flag is set if the 
original value was odd, th^t is, if there is a remainder from the division. 
The arithmetic shift right 



SRA 



shifts each bit one position to the right, but the original high-order bit is 
unchanged. 



•f ! ! !- 

sccuniulator 



- ! — 

-> 



carru 



This operation can be used to divide a signed number in half. The high-order 
bit, the sign bit, is unchanged. As with the logical shift right, the carry flag is 
set if the original number was odd. 



CHAPTER TWO 

Number Bases 
and Logical Operations 



In this chapter we will consider how numbers are stored in a computer. We 
will also look at some of the operations that can be performed on these 
numbers. But first we will review the representation of numbers in general. 
When we write a number such as 245, we usually mean the quantity 5 plus 
40 plus 200. 



This is the ordinary decimal or base-10 representation of a number. The 
rightmost digit gives the number of units. The digit immediately to the left 
is the number of tens (the base). The next digit to the left is the number of 
100s (the base squared). 

In assembly language programs it is sometimes convenient to represent 
numbers with a base of 2, 8, or 16. In the octal, or base-8, system, for exam- 
ple, the number 245 is equivalent to the decimal number 165 (5 plus 32 
plus 128). 



2 4 5 



(decimal) 



5X 1= 5 

4 X 10 = 40 (4 X the base) 

2 X 100 = 200 (2 X the base squared) 



245 (decimal) 



2 4 5 



(octal) 



5X1 
4X8 
2 X 64 



5 
32 
128 



(4 X the base) 

(2 X the base squared) 

(decimal) 



165 



16 
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This example demonstrates how to convert numbers from other bases into 
the decimal representation by adding up the decimal equivalent of each digit. 

In the binary, or base-2, system, only the digits and 1 are used. The 
individual digits are called bits, an acronym for binary digits. The rightmost 
bit represents the units. The bit immediately to the left is the number of 2s 
(the base). The next bit to the left is the number of 4s (the base squared). 
We continue in this way through all of the bits. For example, the binary 
number 

10100101 

is equivalent to the decimal number 165. The conversion is obtained in the 
following way. 

10100101 (binary) 

L — IX 1 = i' 

I ox 2= 

I IX 4 = 4 

I . OX 8 - 

I X 16 = 

I IX 32 = 32 

I ___ X 64 = 

I . 1 X 128 = 128 

165 (decimal) 

We have seen that the decimal system utilizes ten different digits (0-9). 
The octal system, however, utilizes only eight digits (0-7), and the binary 
system uses only two (0-1). The hexadecimal, or base-16, system is also 
commonly used in computer programs. With this method, we need 16 differ- 
ent digits. The problem is that if we use all of the digits (0-9) from the 
decimal system, we will still be six digits short. The solution is to use the 
letters A through F to represent the digits beyond 9. Thus, the hexadecimal 
number A5 is equivalent to the decimal number 165. We can convert a hexa- 
decimal number into decimal in the usual way if we remember that A stands 
for decimal 10, B for 11, and so on. 

A 5 (hexadecimal) 

I 5X1= 5 

I 10 X 16 = 160^ (10 times the base) 

165 (decimal) 

The first 16 integers of the decimal, binary, octal, and hexadecimal systems 
are shown in Table 2.1. 
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Table 2.2. The first 16 integers represented 
in various number systems. 



decimal 


binary 


octal 


hex 





0000 


000 


00 


1 


0001 


001 


01 


2 


0010 


002 


02 


3 


0011 


003 


03 


4 


0100 


004 


04 


5 


0101 


005 


05 


6 


0110 


006 


06 


7 


0111 


007 


07 


8 


1000 


010 


08 


9 


1001 


Oil 


09 


10 


1010 


012 


OA 


11 


1011 


013 


OB 


12 


1100 


014 


OC 


13 


1101 


015 


OD 


14 


1110 


016 


OE 


15 


1111 


017 


OF 



Table 2.1 shows the common practice of displaying leading zeros on 
numbers expressed in bases other than 10. Thus we write 5 for a decimal 
number, but we may write 005 if it is an octal number or 05 if it is a hexa- 
decimal number. We may explicitly represent the base by a suffix. In books, 
for example, we typically utilize a subscript in smaller size type. Thus we 
will write: 

IOIO2 (binary) 
ITg (octal) 
17 10 (decimal) 
17 16 (hexadecimal) 

Alternately, we use suffixes of B, Q, D, and H to designate, respectively, 
binary, octal, decimal, or hexadecimal mode in computer programs where 
subscripts are not available. 

lOlOB (binary) 

17Q (octal) 

17D (decimal) 

17H (hexadecimal) 

(The letter Q is used instead of an O for an octal number to avoid confusion 
vdth zero.) 

Binary numbers such as 

011001101111 
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can be difficult to read, so it is common practice to represent them in octal 
or hexadecimal form. Conversion to octal is easy if the bits are grouped by 
threes. 

Oil 001 101 111 (binary) 
3 15 7 (octal) 

Grouping by fours facilitates the conversion to hexadecimal. 

0110 0110 1111 (binary) 

6 6 F (hexadecimal) 

NUMBER REPRESENTATION IN BINARY, BCD, AND ASCII 

All information is ultimately stored in computers as a series of binary digits. 
There are, however, several different coding schemes for representing the 
original data. The simplest method is to use straight binary coding, as shown 
in Table 2.1. Notice that we might choose to represent a binary value in 
decimal, octal, or hexadecimal notation. The number itself is unchanged by 
this. The decimal number 12, for example, is stored as the binary number 
1100. 

A different method of representing data is called binary coded decimal 
(BCD). Actually, there are two types of BCD: unpacked and packed. With 
unpacked BCD, each byte contains a single decimal digit from to 9. Packed 
BCD can have one or two decimal digits in each byte. Thus, a packed BCD 
number can range from to 99. By comparison, an 8-bit binary number can 
range from to 255. Table 2.2 shows the first 16 integers in BCD. The first 
column gives the decimal equivalent, the second column the corresponding 
bit pattern. 

Table 2,2. The first 16 integers represented in 
decimal and binary-coded decimal (BCD). 



decimal 


BCD 





0000 0000 


1 


0000 0001 


2 


0000 0010 


3 


0000 0011 


4 


0000 0100 


5 


0000 0101 


6 


0000 0110 


7 


0000 0111 


8 , 


0000 1000 


9 


0000 1001 


10 


0001 0000 


11 


0001 0001 


12 


0001 0010 


13 


0001 0011 


14 


0001 0100 


15 


0001 0101 
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Notice that the binary representation for the decimal numbers through 9 
is the same for both binary and for BCD. 

A third method for encoding data is called ASCII. This scheme is com- 
monly used with peripherals such as printers and video terminals. When the 
key labeled 2 of . an ASCII console is pressed, the bit pattern 

0011 0010 

is generated. Table 2.3 gives the bit patterns for the ASCII digits 0-9 in 
binary and hexadecimal notation. 

Table 2.3. The bit pattern for the ASCII digits 0-9. 



digit 


binary 


hexadecimal 





0011 0000 


30 


1 


0011 0001 


31 


2 


0011 0010 


32 


3 


0011 0011 


33 


4 


0011 0100 


34 


5 


0011 0101 


35 


6 


0011 0110 


36 


7 


0011 0111 


37 


8 


0011 1000 


38 


9 


0011 1001 


39 



LOGICAL OPERATIONS 

The fundamental operations of a computer involve electrical signals that can 
have only one of two values. The two voltage levels might be zero and 5 
volts, for example, or they might be something else. The actual value is 
unimportant at this point. Instead, we refer to the two allowable states as 
TRUE and FALSE. The TRUE state is also called a logical 1, or high state, 
and the FALSE state is also known as a logical 0, or low state. 

TRUE =1 (high) 
FALSE =0 (low) 

Computers store numbers in binary form as a series of Is and Os. These two 
possible values correspond to the two possible voltage levels of the electronic 
circuitry. We can therefore utihze the expressions TRUE and FALSE to 
describe the state of each bit. 

The collection of transistors, resistors, and so forth that makes up the 
physical computer is called the hardware. The computer program used to 
direct the activities of the computer is termed the software. In this sense, the 
hardware and software are distinctly different. But sometimes we use these 
terms a little differently. 
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Consider, for example, one of the major differences between minicom- 
puters and microcomputers. Minicomputers contain electronic circuitry for 
the multiplication of two numbers. Since microcomputers do not contain 
such circuitry, multiplication is performed instead by executing a special 
computer program. We say that minicomputers perform multiplication by 
hardware, but that microcomputers must do multipUcation by software. 

Hardware operations are performed by electronic devices called gates. 
The internal structure of the gate is unimportant if we are only interested in 
the logic of its operation. There are input signal lines that are sampled by the 
gate, and there is an output signal that is generated by the gate. When we 
consider the logical operations that are performed by a computer, we can 
imagine that they are accomplished either by hardware or by software. The 
answer is the same. 

A common logical operation is the complement or inversion of a binary 
digit. The complement of is 1 and the complement of 1 is 0. The hardware 
complement is performed with an inverter or NOT gate. The electronic 
symbol for this gate, shown in Figure 2.1, is a triangle with one apex to the 
right (usually) or to the left (sometimes). A small circle or triangle at this 
apex completes the symbol. 




Figure 2.1. The electronic symbol for the NOT or inverter gate. 

Letters of the alphabet are used to designate input or output signals. 
These binary signals can have one of two states, termed TRUE (1) or FALSE 
(0). The letter A with a bar over it (A) represents the complement of A and 
is called NOT A. A truth table is used to summarize the possible states. 

A A or A A 

1 FALSE TRUE 

1 TRUE FALSE 



THE TWO'S COMPLEMENT 

If each bit of an 8-bit byte is complemented, we produce a result that is 
termed the one's complement of the byte. 

0000 1001 = 9 

1111 0110 = one's complement of 9 

Both the 8080 and the Z-80 CPUs provide an operation code for comple- 
menting the accumulator. A slightly different operation is the two's com- 
plement. It is obtained by incrementing (adding 1 to) the one's complement 
of a number. For example: 
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0000 1001 = 9 

1111 0110 = one's complement of 9 
+ 0000 0001 add one 



1111 0111 = two's complement of 9 

It is interesting to note that the sum of a number and its two's comple- 
ment is zero. 

1010 1010 = 170 

0101 0101 = one's complement of 170 
+ 0000 0001 add one 



0101 0110 = two's complement of 170 

0101 0110 = two's complement of 170 
+ 1010 1010 = 170 



0000 0000 sum 

Adding the two's complement of a number produces the same result as 
subtracting the number itself. For example, we can subtract 170 from 223 
by adding the two's complement of 170. The result is the same. 

1101 1111 = 223 
- 1010 1010 = 170 

0011 0101 = 53 



or 



1101 1111 = 223 

0101 0110 = 2 's complement of 170 



0011 0101 = 53 

The 8080 CPU can perform both addition and subtraction with 8-bit 
numbers and it can add 16-bit numbers, but there is no 16-bit subtraction 
operation. We can effectively perform a 16-bit subtraction, however, by 
adding the two's complement. Suppose that the HL register pair contains 
the decimal value 10,005 and we want to subtract 10,000 from it. The dif- 
ference between 10,005 and 10,000 can be obtained by adding the two's 
complement. Consider the bit pattern for the number 10,000. 



0010 0111 0001 0000 = 10,000 
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We first form the one's complement, then increment the result to form the 
two's complement. 

1101 1000 1110 1111 = one's complement of 10,000 
+ 0000 0000 0000 0001 add one 



1101 1000 1111 0000 = two's complement of 10,000 

Finally, we add this two's complement to the value in HL. 

0010 0111 0001 0101 = 10,005 in HL 
+ 1101 1000 1111 0000 two's complement of 10,000 



0000 0000 0000 0101 difference (sum) is 5 

When an assembler encounters a negative argument, it will automati- 
cally calculate the corresponding two's complement. Thus the 8080 ex- 
pression 

LXI = Dr-lOOOO 

will place the bit pattern 

1101 1000 1111 0000 
in the DE register pair. The instruction 

DAD D 

will then effectively perform a 16-bit subtraction on the number in HL. 



LOGICAL OR AND LOGICAL AND 

In the previous section, we considered the logical operation of NOT. Two 
other important logical operations are OR and AND. Both of these opera- 
tions reflect the usual EngHsh meaning. The logical OR of two bits results in 
a value of TRUE (1) if either or both the original values are TRUE., The 
result is FALSE otherwise. The logical AND of two values gives an answer 
of TRUE (1) if and only if both of the original values are TRUE. If either or 
both the original values are FALSE, then the answer is FALSE. 

Equations of logical operations can be written using the appropriate 
symbols. Two OR operators are in common use: a plus symbol and a V- 
shaped symbol. The AND operator is either a dot or an inverted V. The 
schematic representations of the OR and AND gates are shown with their 
corresponding mathematical representations in Figure 2.2. 
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A- 

B- 



X = A + B 



A- 
B- 



■X = A • B 



Figure 2.2. The OR and the AND gates. 

The truth table is 



A 


1 
1 



B 

1 

1 



(OR) 
A+B 



1 

1 

1 



(AND) 
A-B 



1 



where zero means FALSE and 1 means TRUE. The origin of the + symbol 
for the OR operation and • symbol for the AND operation can be seen from 
the truth table. Logical operations are performed separately on each bit, and 
there is never a carry. The logical OR (sum) of A and B gives zero if both 
bits are zero, but 1 otherwise. (Binary digits can't be larger than 1.) The 
logical AND (product) of A and B gives zero if either or both bits are zero 
and uuity otherwise. 



SETTING A BIT WITH LOGICAL OR 

Sometimes, we need to set one or more bits of the accumulator. We can use 
the logical OR operation for this purpose. From the truth table in the pre- 
vious section, we can see that a logical OR of 1 with either a or a 1 will 
give a result of 1. 

A B A+B 

10 1 

11 1 

Thus, a logical OR of any bit with a 1 will set that bit. On the other hand, a 
logical OR of and another bit gives the result of that other bit. 

A B A+B 


1 1 

In this case, the second bit is not changed. 

Suppose that the accumulator contains a binary 5 and we want to con- 
vert it to an ASCII 5. 

0000 0101 = binary 5 
0011 0101 = ASCIIS 
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If we compare the two bit patterns, we can see that they are the same except 
for bits 4 and 5. These bits can be set by executing a logical OR with an 
ASCII zero. 

0000 0101 = binary 5 
OR 0011 0000 = ASCII zero 



0011 0101 = ASCII 5 

The OR operation has set the bit corresponding to the location of the 1, but 
it has left the other bits unchanged. 

A logical OR of a register with itself does not change the value. 

0101 1010 = 5Ahex 
OR 0101 1010 = 5Ahex 



0101 1010 = 5Ahex 

But this operation can be used to set the flags. In this example, the zero, 
carry, and sign flags are reset and the parity flag is set. 



RESETTING A BIT WITH LOGICAL AND 

A logical AND operation can be used to reset any particular bit of the 
accumulator; the truth table shows how. A logical AND of and either a 
or a 1 will always give a result of 0. 

A B A-B 



10 

Thus, the bit is reset. On the other hand, a logical AND of 1 and another bit 
will give the value of the other bit. 

A B A-B 
10 
111 

Thus the AND instruction can be used to reset or "turn off" particular bits. 
This step is sometimes called a masking AND operation. 

.When the CPU reads an ASCII character from the console, it gets an 
8-bit byte. But since the ASCII code contains only 7 bits, the high-order bit 
is not needed. The console-input routine typically resets this bit by per- 
forming a masking AND operation. Suppose that the console transmitted an 
ASCII 5 with the high-order bit set. The bit pattern looks like this. 



1011 0101 
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The high-order bit can be reset with an AND operation. 



1011 0101 (original byte) 
AND 0111 1111 (mask) 



0011 0101 (ASCIIS) 



LOGICAL EXCLUSIVE OR 



The ordinary OR operation is sometimes called an inclusive-or operation to 
distinguish it from the exclusive OR (XOR) operation. For this latter opera- 
tion, the result is TRUE only if the corresponding bits of both values are 
different. Either A or B must be TRUE, but not both. The XOR operation 
is represented by a plus symbol surrounded by a circle. The complement of 
the XOR is the exclusive NOR or XNOR. It can be used as a comparator. 
The hardware implementation is sometimes used in circuitry to enable 
memory boards. The result is TRUE if and only if both corresponding bits 
are identical. The result is FALSE otherwise. The truth table is: 



The exclusive OR of a bit Avith itself will always be FALSE. Therefore the 
XOR of the accumulator with itself will set it to zero. 

0111 1100 = 7Chex 
XOR 0111 1100 = 7Chex 



The corresponding electronic symbols for the hardware implementation of 
the XOR and XNOR are shown in Figure 2.3. 



A 


1 
1 



B 

1 

1 



A©B 

1 
1 




A®B 
1 


1 



0000 0000 



zero 





Figure 2.3. The exclusive or (XOR) and comparator (XNOR) gates. 



LOGICAL NAND AND NOR GATES 



By combining an inverter gate in series with the AND and OR gates, a new 
set of gates is formed. The NOT AND gate is called a NAND gate; it is shown 
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in Figure 2.4. The NOT OR gate is known as a NOR gate; it is shown in 
Figure 2.5. 



A. 
B- 



X = A • B 



A- 
B- 




X = A • B 



Figure 2.4. The NAND gate can be produced from an AND gate and a NOT gate. 




X = A + B 



=0- 



'X = A + B 



Figure 2.5. The NOR gate can be formed from the OR gate and the NOT gate. 



From the truth table, it can be seen that the outputs of the NOR and NAND 
gates are the inverse of the corresponding OR and AND gates. 



A 


B 


A+B 


A-B 








1 


1 





1 





1 


1 








1 


1 


1 









If both inputs of the NOR gate are connected together, then the gate 
behaves like a NOT gate. The same is true for the NAND gate. This can be 
seen by comparing the first and last rows of the truth tables. In this way, 
two NOR gates can be combined serially to produce an OR gate. The result 
is a NOT NOT OR gate that is equivalent to an OR gate. This is shown in 
Figure 2.6. In a similar way, two NAND gates can be used to make an AND 
gate as shown in Figure 2.7. Since OR and AND gates cannot be similarly 
combined to produce the NOR and NAND gates, we will find that NAND 
and NOR gates are more common. 




X=A+B=A+B 



Figure 2.6. An OR gate is formed from two NOR gates. 



A- 
B- 



> 



A • B 



> 



X = A • B = A • B 



Figure 2.7. Two NAND gates are combined to produce an AND gate. 
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MAKING OTHER GATES 

NOR and NAND gates are very versatile. NOR gates or NAND gates can be 
combined to produce all of the other gates. This can be seen from the fol- 
lowing truth table. 



A 


B 


A 


B 


A+B 


A-B 


A+B 


A-B 


A+B 


A-B 








1 


1 








1 


1 


1 


1 





1 


1 





1 





1 








1 


1 








1 


1 





1 








1 


1 


1 








1 


1 















Notice that column 7 of the truth table has the same values as the last 
column. Similarly, columns 8 and 9 are identical. These relations follow 
De Morgan's theorem, which can be expressed mathematically as: 



A + B = A ■ B and 
A • 1"= A + B 

The corresponding digital gates are shown in Figures 2.8 and 2.9. 



formed from four NOR gates. 



A ■ B 

^ X = A • B = ATB 



Figure 2.9. A NOR gate is obtained from four NAND gates. 

The use of a small circle to represent inverted output brings up another 
approach to the understanding of digital logic gates. In the more commonly 
used system, the small circles are used only on the output side of the gate. 

Another approach, however, is to always connect active-high outputs 
to active-high inputs, and active-low outputs to active-low inputs. For this 
latter system, NAND gates will sometimes appear as OR gates with inverted 
inputs, and NOR gates will sometimes appear as AND gates with inverted 
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inputs. According to De Morgan's theorem, the NAND gate is equivalent to 
the OR gate with inverted input signals. This is demonstrated in Figure 2.10. 
The circuit shown is logically the same as the one shown in Figure 2.9. 
Notice that the active-low outputs of the first NAND gates are connected to 
the active-low inputs of the next OR gate. That is, there are small circles on 
the outputs of the first gates and on the inputs of the second gate. 



A 



A + B 









or 











t=I>- 



■X = A + B 



A + B 



B 



Figure 2.10. A NOR gate is produced from four NAND gates. Tiie middle NAND 
gate is shown in its alternate representation. 



CHAPTER THREE 

The StHck 



When main memory is used to store a collection of data, each member of 
the data set is individually accessible. This type of storage is termed random 
access memory (RAM). Magnetic tape storage, by contrast, is serial or 
sequential access memory. In this latter case, only one item of the set is 
available at any one time. There are two ways of storing and retrieving the 
items in a serial memory buffer: one is by means of a first-in, first-out 
(FIFO) buffer, and the other is by means of a last-in, first-out (LIFO) buf- 
fer. We can visualize the serial buffer as a long string of information. With 
the FIFO buffer, items are added at one end and removed from the other. 
This buffer is analogous to an escalator: the people who ride the escalator 
are like the data— those who get on first, get off first. 

In 

■ dat3 f 
! data ! 



data 



! data ! 
Out 

Figure 3.1. The first-in, first-out (FIFO) buffer. 

With the LIFO buffer, on the other hand, the data are added and 
removed at the same place. This arrangement is analogous to a very long, 
narrow elevator. Those who get on first, have to wait untU everyone else is 
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off before they can get off. It can be seen that magnetic tape is a FIFO 
medium. 



data 



data 



data 



! dsts ! 
In Out 

Figure 3.2. The last-in, first-out (LIFO) buffer. 

Sometimes, a special area of main memory is designated as a LIFO 
buffer even though each member of the buffer is individually accessible. 
This region is known as a stack. As an example, Hewlett-Packard calculators 
utilize a very short LIFO stack, consisting of registers known by the letters 
Y, Z, and T. An item in any of the registers is individually accessible, yet the 
stack as a whole can be manipulated. As data is entered from the keyboard, 
it is placed into the X register. This information can then be transferred to 
the stack (register Y in this case) by pressing the ENTER key. We say that 
the contents of the X register are pushed onto the stack. Items can be 
retrieved from the stack and placed in the X register with the roll-down (R) 
key. We say that data are popped from the stack into the X register by this 
means. Another stack operation is performed by the EXCHANGE key which 
is used to swap the contents of the X and Y registers. 

STORING DATA ON THE STACK 

We have seen in the previous chapters that the 8080 and Z-80 microprocessors 
incorporate general-purpose registers for the storage of information. But 
these registers are limited in number. Consequently, a special area of main 
memory is designated for the additional storage of information. This area, 
called the stack, is implemented on the Z-80 and 8080 as a last-in, first-out 
serial buffer even though each item in the stack is individually accessible. 
One of the CPU registers, the stack pointer, references the current location 
in memory. This is the address of the most recently added item. The stack 
pointer is decremented as items are added and incremented as items are re- 
moved. The programmer may place the stack anywhere in memory by load- 
ing the stack pointer with the desired address. For example, the instruction 

LD SP»4000H <Z-80) or 

LXI SPf4000H <8080> 

initializes the stack to location 4000 hex. 
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Data can be placed on the stack with one of the PUSH operations. A 
command of 



<Z-80) (8080) 
PUSH HL PUSH H 



will move a copy of HL to the stack. Since main memory is addressed eight 
bits at a time, the PUSH operation is actually performed in two stages. The 
stack pointer is decremented, then the H register (the high half) is copied to 
the stack. The stack pointer is decremented a second time and the L register 
(the low half) is copied to the stack. The stack pointer register now contains 
the address of the low byte. Figure 3.3 demonstrates the action of a PUSH HL 
command. The region of memory devoted to the stack is shown with higher 
memory upward. The arrow represents the stack pointer. 

ress 
4000 
3FFF 
3FFE 



j I I 

HL ! hiSh ! low ! _ 

I I 1 



Ac 



SP 
===> 



SP 
===> 



hish 



SP 



hiah 
low 



Figure 3.3. The HL register is pushed onto the stack. 



The POP instruction reverses the PUSH process. For example, a POP DE 
command copies 16 bits from the stack into the DE register. Because the 
stack operates in a LIFO manner, the most recently added byte is removed 
first. This is placed into register E (the low half of the DE pair). The stack 
pointer is automatically incremented and the next byte is transferred from 
memory to register D (the high half). The stack pointer is then incremented 
a second time. Figure 3.4 demonstrates the operation. Notice that the data 
originally pushed onto the stack is still present. 



SP 

===> 




SP 



Address 
4000 
hlalh t 3FFF 



low 



3FFE 



Figure 3.4. Two bytes are popped from the stack into DE. 
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It can be seen that the stack grows downward in memory as data are 
pushed into it, and it moves back up as data are popped off. For this reason, 
it is common practice to initialize the stack pointer to the top of usable 
memory. Actually, the stack pointer can start at one address above the top 
of memory since the stack pointer is always decremented before use. 

If the general-purpose registers contain important information but they 
are -needed for a calculation, it will be necessary to save the original data. 
This can be easily done by pushing the contents onto the stack. The registers 
are restored at the end of the calculation with the three corresponding POP 
commands. The operation goes like this. 



PUSH HL fsave HL 

PUSH DE fsave DE 

PUSH BC leave BC 

* «■ « 

» $ do the calculation 

♦ # # 

POP BC S restore BC 

POP DE ( restore DE 

POP HL ; restore HL 



Notice that the order of the POP commands is reversed from that of the 
PUSH sequence. This is necessary because of the stack's LIFO operation. 



SP 



STACK 
H 



SP 



PUSH H 



PUSH D 



H 
L 

n 

E 



SP 



H 
L 
D 
E 

B 
C 



PUSH B 



Figure 3.5. The contents of the general-purpose registers are saved on the stack. 
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STACK 



! ! 1 1 SP ! ! 

! H ! ! H ! > H ! 

1 ! SP ! ! ! 1 

! L ! ===> ! L ! ! L ! 

! D ! ! D ! ! D ! 

SP ! I ! I ! ! 

===> ! E f ! E I • E ! 

i B ! ! B i ! B ! 

! C ! ! C ! ! C ! 

POP B POP D POP H 



Figure 3.6. The original contents of the general-purpose registers are restored 
from the stack. 



THE ACCUMULATOR AND PSW AS A DOUBLE REGISTER 



The 8-bit accumulator and the 8-bit flag register are treated as a 16-bit 
double register for the PUSH AF and POP AF instructions. In this case, the 
accumulator is treated like the high byte since it is pushed onto the stack 
first. The flag register is pushed onto the stack second. Figure 3.7 demon- 
strates this. 



stack 



SP 




SP 
! ~> 

! 
I 
I 



stack 
A 

flaas 
A 

f lass 



Figure 3.7. 



PUSH PSW POP PSW 

Contents of the accumulator and flag registers are pushed onto the stack. 
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Data can be moved from one register pair to another by using a 
PUSH/POP combination. For example, the two 8080 commands 

PUSH H 
POP n 

will move H to D and L to E. This is not the most efficient way to accom- 
plish the move, however. The sequence requires access to main memory and 
so is slower than the direct register moves 

MOV DfH 
MOM EfL 



Z-80 INDEX REGISTERS 

The Z-80 has two, 16-bit index registers that can participate in the PUSH 
and POP operations. However, the instructions each require two bytes com- 
pared to the other PUSH and POP instructions which only require one byte 
each. As a result, the execution time is slower than the other PUSH and 
POP instructions. There are no official instructions for moving data between 
the index registers and the general-purpose registers. This transfer can be 
performed, however, by use of the PUSH and POP commands. The two 
instructions 

PUSH IX 

POP BC 

will copy the IX register into the BC register. 



SUBROUTINE CALLS 

We have seen that the PUSH instructions can be used by the programmer to 
store data on the stack. The 8080 and Z-80 CPUs use the stack for a second 
purpose: storing the return address when a subroutine is called. Subroutines 
are used to efficiently code a set of instructions needed at several different 
places in a computer program. A subroutine is called by using the assembly- 
language mnemonic CALL. At the end of the subroutine, indicated by the 
return statement, control is automatically returned to the calling program. 

1 1 csll 

• celling ! 

• program ! < 

I j Return 

The input and output routines which control the console may be 
needed at several locations in a program. Consequently, they are coded as 



! subroutine 
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subroutines. The 8080 assembly language subroutine for the console might 
look like this. 



output: in 

AMI 

J2 

HOM 

OUT 

RET 



STATUS 

INMSK 

OUTPUT 

A>B 

DATA 



CHECK STATUS 
INPUT HASK 
NOT READY 
GET DATA 
SEND DATA 
DONE 



Data can be output from anywhere in a program by placing the byte in the 
B register and calling the output subroutine. The following examples of 
8080 assembly language mnemonics show how a question mark and a colon 
can be printed by calling the console output routine. 



WHATt HVI 

CALL 



B» '?' f OUTPUT A ? 
OUTPUT 



« • « 



COLON t mi 

CALL 



Bf'i' 
OUTPUT 



f OUTPUT A COLON 



» » 4 



The above examples utilize the unconditional subroutine call and 
unconditional return instructions. Conditional call and return instructions 
are also available. These commands perform the appropriate call or return 
only if the referenced PSW flag is in the desired state. The four flags^zero, 
sign, carry, and parity— give rise to eight conditions. 



zero 
not zero 
plus 
minus 
carry 
not carry 
parity even 
parity odd 



These instructions are discussed in more detail in Appendix H. 

The stack provides the mechanism for subroutine operation. When a 
CALL instruction is encountered, the address immediately following the 
CALL statement is automatically pushed onto the stack. The subroutine 
address is then loaded into the program counter register. The program 
counter tells the CPU which instruction to execute next. Since a subroutine 
CALL uses the stack, the programmer must be sure that the stack is properly 
defined prior to a subroutine CALL. When a return instruction is subse- 
quently encountered, the return address is popped off the stack and placed 
into the program counter. After return from a subroutine, program execu- 
tion continues with the instruction following the CALL statement. 
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PASSING DATA IMPROPERLY TO A SUBROUTINE 



Since the stack can be used for storing both data and subroutine return 
addresses, the programmer must ensure that there are no conflicts. First, 
there should normally be as many POP instructions as PUSH instructions. 
Second, one must be careful not to PUSH data onto the stack, CALL a sub- 
routine, then POP data off the stack. The LIFO nature of the stack will 
cause trouble in this case. 

PUSH 
CALL 

t * * 
* * « 

order: • * ♦ 

POP 

« t « 

RET 



H 

ORDER > ! 

I 

! 

H 

> > ?'??? CRASH I 



Figure 3.8 shows an example of improper mixing of data and the return 
address on the stack. Higher memory is upward and lower memory is down- 
ward. The arrow indicates the current stack pointer position. 



SP 



STACK 

d3t3 



SP 



data 
address 
I 



SP 



HrL 



> dsta ! 
I ! 



address 



PUSH H 



CALL ORDER 



POP H 



RET 



Figure 3.8. Improper mixing of data and the return address on the stack. 



In this example, the data is first pushed onto the stack while in the main 
program. The return address is then pushed onto the stack next, when the 
CALL instruction is encountered. The POP instruction in the subroutine will 
actually load the HL register pair with the subroutine return address rather 
than the data that was expected. This occurs because the data was pushed 
onto the stack before the return address. Worse yet, the RET instruction will 
load the program counter with the data, rather than with a useful address. 
Strange things are likely to happen when the CPU attempts to execute 
instructions at an address defined by the data. 



PASSING DATA PROPERLY TO A SUBROUTINE 

This section demonstrates a proper way to pass data into a subroutine by 
using the stack. The task can be accomplished with the 8080 XTHL instruction 
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or the Z-80 EX (SP),HL instruction. This operation exchanges the HL 
register pair with the two bytes at the current stack position. The instruction 
is analogous to the X/Y EXCHANGE key on an HP calculator. 

The method works in the following way. The data is pushed onto the 
stack while control is in the calling program. When the subroutine is called, 
the return address is pushed onto the stack, just after the data. A POP 
instruction, executed in the subroutine, delivers the return address to the HL 
register. Now, the XTHL instruction exchanges the HL register with the 
stack. The desired data is now in HL and the return address is on the stack. 
Finally, a return instruction will correctly return control to the calling 
program. 



PUSH 
CALL 



ORDER 



f main proarsm 
} call subroutine 



order; 



POP 
XTHL 



f start of subroutine 
i Set return address 
t ewchanae with data 



RET 



i return to main program 



STACK !■ 



! SP •■ 



! data 

SP ! 

===> f address 
I 



• ! SP ! • 



===> ! data ! ===> ! address 



I 1 

HL ! address ! 
! , 



i data < 

I 1 



CALL POP H XTHL RET 

Figure 3.9. Proper mixing of data and return address on the stack. 



It is important to note that the XTHL command only works with the 
HL register. There is no equ^lvalent instruction for the DE or BC registers. 
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PASSING DATA BACK FROM A SUBROUTINE 

A variation of the XTHL technique is also possible. Data can be pushed onto 
the stack from within a subroutine, then retrieved after returning to the 
calling program. 



CALL 

POP 



FETCH 
H 



rGET THE DATA 



FETCH J 



LXI 

XTHL 

PUSH 



Hf DATA 



fPUT IN HrL 
J SWITCH STACK 
>RET ADDR 



RET 



DATA in this case is predefined and is part of the LXI instruction. 



stack stack 

SP ! ! SP ! ! 

===> t address ! ===> ! data ! 

1 1 j j 



HL ! data 
I 



CALL 



address 



XTHL 



STACK 



SP 



PUSH H 



1 gp !. 

data ! ! 

1 t . 

address ! 
1 

RET 



data 



Figure 3.10. Using tlie stack to pass data back from a subroutine. 
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An extension of the XTHL technique allows additional data to be 
passed on the stack. 

CALL FETCH 
POP B fDATA 3 

POP D fDATA 2 

POP H fDATA 1 



fetch: . . . 



LHLD 


DATAl 


IDATAl TO HfL 


XTHL 




(SWITCH STACK 


XCHG 




f STACK TO DE 


LHLD 


DATA2 


;GET DATA2 


PUSH 


H 


IPUT ON STACK 


LHLD 


DATA3 


>GET DATA3 


PUSH 


H 


»PUT ON STACK 


PUSH 


D 


>RET ADDR TO STACK 


RET 







In this example, the return address is first moved to the HL pair with the 
XTHL command. Then it is moved to the DE register pair with the XCHG 
instruction. Three sets of 16-bit data are obtained from the memory ad- 
dresses pointed to by the arguments of the LHLD instructions DATAl, 
DATA2, and DATA3. The first set is placed on the stack with the XTHL 
command. Then the other two are pushed onto the stack. Next, the return 
address, previously saved in the DE register pair, is pushed onto the stack. A 
final RET instruction pops the return address from the stack into the pro- 
gram counter. 



SETTING UP A NEW STACK 

Sometimes it is desirable to save the current stack pointer and set up a new 
one. When this happens, the original stack pointer is restored at the conclu- 
sion of the task. The technique is particularly useful when one independent 
program is executed by another. The original stack pointer is saved in a 
memory location, then retrieved at the end of the program. 

If the current program was reached through a subroutine call, the 
return address for the calling program should be the current address on the 
original stack. It is this address that must be saved. 

There is a Z-80 instruction that allows the old stack pointer to be 
stored directly in main memory. The instruction looks like this. 

I Z-80 VERSION 
} 

START? LD (OLDSTK)!'SP >s3ve st3ck 

LIi SP? STACK (new stack 



e # » 

LD 
RET 



SPp (OLDSTK) 



fSet old stack 
(done 
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At the conclusion of the task, the old stack pointer is restored. With an 
8080 CPU, the job is more complicated since the stack pointer cannot be 
directly saved. In this case, the stack pointer is moved to the HL register 
pair which is in turn saved in memory. This is done by first zeroing HL, then 
adding in the stack pointer. At the end of the routine, the old stack pointer 
is loaded into the HL register pair then copied into the stack pointer register. 
Finally, a RET instruction is given. 



start: LXI H,0 Izero HL 

DAD SP JSP to HL 

SHLD OLDSTK 5 save stack 

LXI SPjSTACK >new stack 



LHLD 
SPHL 
RET 



OLDSTK rSet old stack 
5 restore stack 



CALLING A SUBROUTINE IN ANOTHER PROGRAM 

A program may need to call a subroutine that resides in another program. 
But if the second program is revised, the subroutine address in the second 
program will change. This means that the argument of the CALL statement 
in the first program will also have to be changed. 

There are two ways to solve this problem. One method is to provide a 
jump instruction near the beginning of the second program. The address of 
the jump instruction will always be the same. However, its argument, the 
internal subroutine address, can change from one version to the next. The 
first program simply calls CHEK2, and CHEK2 causes a jump to CHEK, the 
desired subroutine. The RET instruction at the end of CHEK will effect a 
proper return to program 1 . 



♦ • ♦ 

AL L 



start: jhp 

■> CHEK2 : JHP 



* » ♦ 
CHEK ! < > « 
RET 



CHEK2 



f Proaram 1 

p call Proaram 2 



CONTIN f start of Pro^raiti 2 
CHEK > 



5to Program 1 



Of course, the second program may need to save the incoming stack, then 
restore it before returning to program 1 . 

A second solution is to place just the two-byte address of the subrou- 
tine near the beginning of the second program. 

start: jhp CONTIN f Program 2 

CHEK2! DW CHEK 
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Now the calling program must put its own return address on the stack and 
get the address of CHEK into the program counter. The following example is 
a way to do this. Notice that program 1 does not enter program 2 with a 
CALL instruction. It uses instead the PCHL instruction which copies the 
contents of HL into the program counter. 



NEXT? 



PUSH 

LXl 

PUSH 

LHLD 

PCHL 

POP 



H 

Hf NEXT 
H 

CHEK2 
H 



jSAME H>L 
iREJ ADDR 
fONTO STACK 

nmo PC 

rORIG HfL 



CALLING ONE SUBROUTINE FROM ANOTHER 

A subroutine called by a main program may in turn call another subroutine. 
When the first subroutine, SUBl, is called, the return address to the main 
program, MAINA, is pushed onto the stack. When the second subroutine, 
SUB2, is called, the return address SUBIA is next pushed onto the stack. 
After the second subroutine has been called, there will be two return ad- 
dresses on the stack: one to get back to SUBl from SUB2, and the other to 
get back to the main program from SUBl. 

CALL SUBl 5MAIN 

haina; » » . < — ! 
« » & I 

I SUBROUTINE 1 ! 
I ! 
SUBll ... ! 

CALL SUB2 ! 
SUBIA 5 ... ! < ! 

RET > — ! ! 

f ! 
J SUBROUTINE 2 ! 
f ! 
SUB2I . . • 

« a * : 

RET > ! 



STACK 

SP • ! 

===> ! MAINA ! 

( I gp 

===> 



MAINA 
SUBIA 



I SP I ! 

===> ! MAINA ! 



CALL SUBl 



CALL SUB2 



RET 



RET 



Figure 3.11. One subroutine calls another. 
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BYPASSING A SUBROUTINE ON RETURN 

It may be that an operation in the sectond subroutine SUB2 makes it desir- 
able to return directly to the main program from SUB2, bypassing SUBl. 
This is easily accomplished if the stack pointer is raised by two bytes before 
executing the return instruction. Of course, care should be taken to see if 
data has been pushed onto the stack after one or both return addresses were 
placed on the stack. The one-byte instruction to increment the stack pointer 
(INX SP) can be executed twice, to raise the stack pointer two bytes. Alter- 
nately, a one-byte POP command can be used if there is a free register pair 
available. 



STACK 

I I gp , , 

! MAIN2 I ==-> ! MAIN2 ! 
SP ! j j , 

===■> f SUBl A ! 

I 1 

CALL SUB2 POP H RET 



Figure 3.12. Skipping one level of subroutine during the return. 



Suppose that an ordinary return from subroutine SUB2 back to sub- 
routine SUBl is desired if the zero flag is set to 1. On the other hand, an 
unusual return directly back to the main program is desired if the zero flag 
is reset to a value of zero. Here is a way to do this. 



MAINi: 



CALL 

» » « 



SUBl 



« « » 

} SUBROUTINE 1 

? 

SUB 1 « # t « 
CALL 

SUBIA* 4 « « 
RET 

> SUBROUTINE 2 
SUB2} , . . 

« * « 

RZ 

POP 

RET 



SUB2 



PSW 



> SUBROUTINE 1 

<- 



p NORMAL RETURN 5 
IRAISE STACK 
»SKIP TO MAIN >- 



The POP PSW instruction raises the stack two bytes so that the final 
RET instruction delivers the return address of MAINI to the program 
counter. This effectively bypasses the intermediate subroutine. 
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A PUSH WITHOUT A POP 

Near the beginning of the system monitor, explained in Chapter 6, there is a 
restart address called WARM. The program normally branches back to this 
point at the conclusion, of each task. Thus the final instruction of each task 
could be: 

JMP WARH 

A more efficient method, however, is to push this restart address WARM 
onto the stack at the beginning of the task. Then if the task does not termi- 
nate within a subroutine, a simple return instruction, rather than a jump, can 
be given at the end of the task. This causes a branch back to WARM. 

warm: LXI HrWARM 5HfL = HERE < 1 

PUSH H >ONTO STACK ! 

« * * Z 

« • « ! 

JZ OPORT • 

• * ♦ - } 

OPORT J ... ! 

RET > 1 

This example is an exception to the rule that we should have a FOP instruc- 
tion for every PUSH. Here, there is a PUSH but no POP. Of course there is 
also a RET with no CALL. So everything is all right— or is it? What happens 
if termination occurs from a subroutine? 



GETTING BACK FROM A SUBROUTINE 



If a particular task terminates in a subroutine, then this subroutine's return 
address must be popped off the stack (or an INX SP instruction must be 
executed twice) before the return is issued. 



warm: . . . 

JZ 

DUHPJ I ! ! 

CALL 

♦ ♦ » 

TSTOPt . . , 
RNC 
POP 
RET 



DUMP 
TSTOP 



J NORMAL RETURN 
fRAISE STACK 
no WARM >— 



The stack pointer grows downward through memory during use. It is 
therefore common practice to place the stack as high as possible in available 
memory. But the system monitor may be located at the actual top of mem- 
ory. In this case the stack can initially be placed lower in memory at the 
beginning of the monitor. 



THE STACK 45 



start: 

LXI SPfSTART 

On the other hand, the monitor may be placed in read-only memory (ROM). 
In this case, the stack can be located at the actual top of read/write memory. 
(While both read/write memory and ROM are random-access memory— 
RAM, it is customary to refer to read/write memory as RAM and read-only 
memory as ROM. This convention will be followed here.) 



AUTOMATIC STACK PLACEMENT 

The placement of the stack at the top of RAM can be done automatically, so 
that the total amount of RAM can be changed mthout having to reprogram 
the PROM monitor. A short routine can test each block of memory starting 
at zero until it finds a location that can't be changed. The stack is then put 
at the beginning of this block. Remember, the stack pointer is always decre- 
mented before use; therefore, it can be initially defined as one location 
above usable memory. 

The first part of the program is a memory search routine that starts at 
address zero. It moves the byte from that location into the accumulator, 
complements it, then moves the complemented byte back to the original 
location. A comparison is made to see if the memory location does indeed 
contain the complemented byte. If it does, the accumulator is comple- 
mented back to the original byte and returned to memory. Such an algo- 
rithm is often called a nondestructive memory test. 

The first byte of each subsequent block of memory is checked in this 
way until a failure is found. This will usually reflect the top of usable mem- 
ory, but of course, it could indicate defective memory. The following pro- 
gram will work properly if placed in read-only memory. 



f ROUTINE TO AUTOMATICALLY PLACE THE 
t STACK AT THE TOP OF MEMORY 



i 8080 


CODE 






t 


LXI 


H»0 


5FIRST ADDR 


NEXTPI 


MOV 


AfM 


J GET BYTE 




CMA 




f COMPLEMENT 




MOW 


M»A 


fPUT IT BACK 




CMP 


M 


J COMPARE? 




JNZ 


TOP 


f NOr DONE 




CMA 




J BACK TO OR 10 




MOV 


Mp A 


J PUT IT BACK 




INR 


H 


fHEXr BLOCK 




JMP 


NEXTP 


fKEEP GOING 


f 

TOP J 


SPHL 




fSET STACK 




CALL 


OUTHL 


JPRINT IT 



46 8080/Z-80 ASSEMBLY LANGUAGE 



This program might not work, however, if it is placed in read/write memory. 
The problem occurs because the routine is changing various locations in 
memory. If it happens to change its own instructions, then the results will 
be unpredictable. 

The shortcomings of the previous program are solved with the follow- 
ing version. The improved version will operate properly no matter where it 
is placed. The stack will be placed at the top of contiguous RAM unless the 
routine itself is m that part of memory. In that case, the stack will be placed 
at the beginning of the program. The Z-80 version is shown, but the program 
can be run on an 8080 if two minor changes are made. The relative jump 
instruction must be changed to an absolute jump and the DJNZ instruction 
must be changed to the equivalent DCR B and JNZ combination. 

i 

i ROUTINE TO AUTOMATICALLY PLACE THE 
i STACK AT THE TOP OF MEMORY 
i FAILSAFE VERSION (Z-80 CODE) 
S 



START J 


LD 


HLf 


> START CHECK AT 




LD 


B» START 


SHR 8 


NEXTPJ 


LD 


A» (HL> 


»GET BYTE 




CPL 




f COMPLEMENT IT 




LD 


<HL) rA 


5 PUT IT BACK 




CP 


(HL) 


;did it go? 




JR 


Zf TOP 


(NOr DONE 




CPL 




?BACK TO ORIS 




LD 


<HL) »A 


» RESTORE 




INC 


H 


JNEXT BLOCK 




DJNZ 


NEXTP 


jARE WE HERE? 


TOPI 


LD 


SPjHL 


J SET STACK 



♦ ♦ * 



The new version works in the following way. The B register initially 
contains the block number of the routine itself. The value in B is decre- 
mented as each successive block is checked. If the routine is in ROM, then 
the end of usable memory will be found, as in the previous version. The 
program will loop between the label NEXTP and the DJNZ NEXTP instruc- 
tion. At some point, the CP (HL) instruction will reset the zero flag and the 
computer will jump to the address of TOP. The stack will then be placed at 
the top of RAM. 

Alternately, if this routine is placed in the lower memory area, then the 
DJNZ instruction will decrement the B register all the way to zero. The zero 
flag will be set and the program will move on to TOP. Now the stack will be 
set to the beginning of the memory block that contains the program itself. 

The START SHR 8 expression at the beginning of the routine instructs 
the assembler to calculate the high byte of the address of START and make 
it the second operand of the LD B instruction. It does this by shifting the 
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address of START by eight bits to the right, then taking the low-order eight 
bits of the result. Some assemblers allow an equivalent operand of 

HIGH START 

which is easier to comprehend. This automatic stack routine is incorporated 
into the system monitor explained in Chapter 6. 



CHAPTER FOUR 

Input and Output 



Computers would not be very useful if they could not interact with the 
outside world. Commands and data are sent to the computer from the key- 
board, magnetic tape, disk, and other peripherals. Results of computations 
are sent back from the computer to the printer, video terminal, tape unit, 
disk, and so on. Such input and output (I/O) transfers on a microcomputer 
are typically accomplished through special memory locations called I/O 
ports. One type of port is distinctly different from main memory. The other 
type of arrangement utilizes one of the regular main memory locations. The 
peripheral in this latter case is then said to use memory-mapped I/O. Each 
method has advantages and disadvantages. In either case, the I/O port will 
trsmsfer eight bits, the natural word size for the 8080 and Z-80 CPUs. 



The I/O instructions on the 8080 microprocessor are rather limited com- 
pared to memory operations. There is a single IN and a single OUT instruc- 
tion fox transferring eight bits of data. In contrast, there is a much larger 
collection of memory operations available. 



These additional instructions can be utilized with memory -mapped I/O, 
greatly increasing the versatility of the Z-80 and 8080 I/O operations. 



MEMORY-MAPPED I/O 



<8080 Hnemonics) 



STA 80 

LOA 81 

MOM M»C 

STAX D 

SHLD 84 



(Z-80 mnemonics) 

LD (80) ^A 

LD A?(81) 

LD (HL) rC 

LD (DE)fA 

LD (84)?HL 



48 
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The STA instruction stores the 8-bit accumulator value at the memory 
address specified by the operand. If this address corresponds to a memory- 
mapped port, then the byte is sent to the peripheral. The LDA command 
reverses the operation. It can be used to input a byte from a port. The 
MOV M,C instruction can be used to transfer a byte from the C register to 
the memory location designated by the HL register pair. The STAX D com- 
mand moves a byte from the accumulator to the memory location desig- 
nated by the DE register pair. The SHLD instruction opens a new dimension. 
Since this operation transfers 16 bits of data from the HL register pair 
directly into two consecutive memory locations, two adjacent ports can be 
simultaneously serviced. 

The typical video console is a serial device that uses distinct ports. 
However, memory-mapped controller boards are commerically available. In 
this case, an ordinary TV set is then used for the video screen. There are also 
disk-controller boards that use memory-mapped operations to communicate 
with the disk drives. It is interesting to note that the Motorola 6600 CPU 
performs all of its I/O by memory mapping. There are no separate input or 
output instructions for this CPU. 



DISTINCT DATA PORTS 

Data ports may be designed to operate either in parallel or in serial fashion. 
Both the parallel and the serial I/O ports are connected to the computer 
through the system bus by a set of eight data lines. In addition, the parallel 
port is connected to the peripheral by another set of eight data lines. The 
serial port, by contrast, has only two data lines connecting it to the peripheral. 

For some peripherals, such as a printer, data is transferred in only one 
direction. For others, such as the console and magnetic tape units, the 
peripheral is able to both send and receive data. In this latter case, there will 
be 16 data lines between the computer and the peripheral if a parallel port is 
used. Eight lines are used for sending data and eight are used for receiving 
data. The serial port, in contrast, will have three signal lines to the peripheral 
if there is two-way communication. One is for transmitting, one is for 
receiving, and the third is a common line for the other two. 

There may be additional lines between the computer and the periph- 
eral. One of these might indicate to the computer whether the terminal is 
operational. Another can be used to inform the terminal that the computer 
is ready. These extra lines are sometimes referred to as handshake lines. 

The computer usually operates at a much higher speed than the periph- 
erals. Consequently, there must be a mechanism for effectively slowing dovm 
the computer during I/O operations. For serial or parallel ports, this is 
typically accomplished by using two separate I/O ports for each peripheral 
device. One port is used for the data port and the other is used for the status 
port. Each of these two ports will have distinct addresses, one of the 256 
values available to the 8080 or Z-80 CPU for this purpose. There are three 
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general methods of performing I/O through data ports: looping, polling, and 
interrupting. 



LOOPING 



Looping is the simplest method of performing I/O through separate ports, 
and it is the one that is most commonly employed in 8080 and Z-80 pro- 
grams. The CPU performs output by sending a byte to the data port using 
the OUT instruction. The corresponding status port is then read with an IN 
instruction. One bit of the 8-bit status port reflects the condition of the 
corresponding peripheral. 

When the CPU places a byte in the data register, using the OUT com- 
mand, the output status bit of the status register is set. This may actually 
result in a logical 1 or a logical zero, depending on the port design. When the 
peripheral utilizes the byte that was placed into the data register, the output 
status bit of the status register is reset. These changes in the status bit are 
automatically handled by the I/O interface hardware. However, the program- 
mer must include in the software the appropriate routines for monitoring 
the status bits. 

As an example of the looping method, consider the following sub- 
routine: 



court IN lOH 

ANI 2 

JZ COUT 

MOV AfC 

OUT ilH 
RET 



» CHECK STATUS 
f SELECT BIT 
INOT READY 
^SET BYTE 
f SEND 
f DONE 



This routine could be used to send a byte of data to the system console. The 
first instruction of the listing causes the CPU to read the 8-bit status port 
which has the address of 10 hex. The second instruction performs a masking 
AND operation to select the write-ready bit, bit 1. Remember that a logical 
AND with zero and anything else gives a result of zero. However, a logical 
AND with unity and a second logical value, gives the result of that second 
value. 

Suppose that the output status is indicated by a logical 1 of bit 1, where 
bit is the least-significant bit of the register. Then, a logical AND with the 
value in the status register and with the number 2 will result in a logical 1 if 
the peripheral is ready. If the device is not ready, however, the result is a 
logical 0. 



0101 0111 status 0101 0101 

AND 0000 0010 = 2 0000 0010 



0000 0000 0000 0010 

reada not resdw 
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Thus, the logical AND with the value of 2 in the status register gives a result 
of zero if bit 1 (the second bit) is 0. Otherwise, a nonzero result is obtained. 

The third instruction in the looping example is a conditional jump. If 
the peripheral is not ready, the JZ instruction will cause the computer to 
loop repeatedly through the first three lines until the peripheral is ready for 
another byte. At this point, the write-ready bit, bit 1, will be a logical 1. 
Then the logical AND operation, the second instruction of the subroutine, 
produces the nonzero value of 2. The MOV instruction following the condi- 
tional jump will then be executed. The byte to be outputted is moved to the 
accumulator, and then sent to data port 11 hex by use of the OUT command. 

When the byte to be output is actually sent to the data port, the write- 
ready flag is reset to a logical zero. The output routine may be immediately 
reentered for outputting another byte, but now the peripheral is not ready. 
Looping will occur again through the first three instructions of the output 
routine since the write-ready flag has been reset to zero. 

The CPU clock may be operating at 2 or 4 MHz. This rate is thousands 
of times faster than the speed of a typical printer. Consequently, if the 
looping method is used, the CPU will be spending over 99 percent of its time 
simply looping through the first three lines of the output subroutine. The 
computer will be spinning its wheels, so to speak, waiting on the peripheral. 

Because the CPU is operating so much faster than the peripherals, it 
can, in principle, service many peripherals simultaneously. A very simple but 
useful implementation of this idea is found on the CP/M* operating system. 
In the CP/M system,* console output is normally sent only to the console. 
This terminal is typically a high-speed video device. But if the user types a 
Control-P, then the hst device is also turned on. Console output will now 
appear simultaneously at both the console and the line printer. 

This technique can be easily observed if the console video accepts data 
much faster than the line printer. Normally, as data is sent only to the con- 
sole, it appears rapidly on the video screen. But when the list device is 
turned on, the output appears much more slowly. The reason for the slow- 
down is that both peripherals are operating at the speed of the slower one, 
in this case the printer. 

A subroutine for accomplishing such a dual output might look like this. 



LOUT! IN LSTAT 

ANI 2 

JZ LOUT 

MOM AfC 

OUT LDATA 

OUT CDATA 
RET 



fLIST STATUS 
r OUTPUT MASK 
JLOOP UNTIL READY 
?GET THE BYTE 
fSEND TO LIST 
I AND CONSOLE 
fVQNE 



CP/M is a registered trademark of Digital Research, Inc., Pacific Grove, California. 
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This routine is not the one that is actually used in the CP/M system since, 
with our routine, the console will always display everything that is sent to the 
printer. This feature does not increase printing time as long as the console 
operates faster than the printer. Notice that there is no need to check the 
console status register. The output rate is set at the speed of the printer, and 
so the console, which operates so much faster, will always be ready if the 
printer is ready. 



POLLING 



One way to improve the performance, or throughput, of a CPU is with a 
technique known as polling. In this method, the CPU sends a byte to each of 
several different peripherals. Each peripheral operates at its full speed. 
Polling is more efficient than the looping method, and has been incorporated 
into several commercial 8080 software products. One product is a multiuser 
BASIC which can service up to four separate consoles. Each user can inde- 
pendently perform calculations using the same BASIC interpreter. 

Another product that uses the polling technique is known as a spooler. 
The looping method is typically utilized for all output. In this case, all other 
activities must be halted while the printer is working. With a spooler pro- 
gram, however, things are different. When this program is incorporated into 
the system, the user can perform other tasks using the system console while 
a disk file is being printed. 

In the polling method, the I/O routines are somewhat different from 
the corresponding routines of the looping method. The output-ready flag of 
the status register is checked periodically as with the looping method. But if 
the status flag indicates that the device is not ready, the CPU returns to per- 
form some other task. Thus, the CPU does not waste time looping around 
the first three instructions of the input or output routine. A typical output 
routine using the polling method might look like tihis. 



LOUT J 



IN 

mi 

RZ 
MOV 
OUT 
RET 



LSTAT J CHECK STATUS 
LMASK I MASK FOR OUTPUT 

>NOT READY 
ArC fGET THE BYTE 

LDATA tSEm IT 



While the polling method is a great improvement over the looping 
method, there are still problems. For example, a decision must be made as 
to how often each status register will be polled. An even better method is to 
use hardware interrupts. 



HARDWARE INTERRUPTS 



The 8080 and Z-80 microprocessors incorporate a hardware interrupt system. 
This feature allows an external device, such as the system console or printer. 
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to interrupt the current task of the processor. When the CPU is interrupted, 
it suspends its current task, and calls on one of several memory locations set 
aside for this purpose. The CPU services the request of the interrupting 
peripheral, then it returns to its previous task. 

In this method, the CPU does not have to be programmed to check the 
peripherals on a regular basis as with the method of polUng; nor does it have 
to waste time in a loop. Instead, the peripheral interrupts the processor when 
it needs service. If several peripherals are able to interrupt the CPU, then 
there must be a method for prioritizing the requests. This ordering is accom- 
plished through a vectored interrupt system. For example, if a lower-priority 
device has interrupted the CPU for service, this phase can also be interrupted 
by a peripheral with a higher priority. On the other hand, a device with a 
lower priority cannot interrupt a higher-priority service, but must wait 
its turn. 

Usually, the highest-priority interrupt will be assigned to updating the 
system clock. If the computer misses a beat, then the time will be incorrect. 
The next lower priority could be assigned to disk transfer. The printer could 
have a low priority since it is a relatively slow device, and it won't matter if 
it must slow down every so often. 

Suppose that the printer is operated by interrupts rather than by loop- 
ing or polling. The computer sends a byte to the printer, then continues with 
another task. When the current byte has actually been printed, the printer 
interrupts the CPU for another byte. In the time between the printing of 
two bytes, the CPU can perform many other tasks. 

The console keyboard is another peripheral that can be readily serviced 
by an interrupt system. In this case, each time the user presses a key, the 
CPU is interrupted from its current task. Of course, if the CPU is currently 
servicing a higher-priority interrupt, then the console keyboard request will 
have to wait. 

Both the 8080 and the Z-80 allocate eight addresses that can be used 
for the interrupt service routines. These addresses can be called by the eight, 
one-byte RST instructions. 



Z-80 


8080 


Instruction code 


Call 


mnemonic 


mnemonic 


hex 


binary 


address 


RST OOH 


RST 


C7 


1100 0111 


OOH 


RST 08H 


RST 1 


CF 


1100 1111 


08H 


RST lOH 


RST 2 


D7 


1101 0111 


lOH 


RST 18H 


RST 3 


DF 


1101 1111 


18H 


RST 20H 


RST 4 


E7 


1110 0111 


20H 


RST 28H 


RST 5 


EF 


1110 1111 


28H 


RST 30H 


RST 6 


F7 


1111 0111 


30H 


RST 38H 


RST 7 


FF 


1111 1111 


38H 



These instructions can be used as one-byte subroutine calls. As an example, 
suppose that the CPU executes an RST 5 instruction which corresponds to 
the instruction code EF hex. A subroutine call is then made to the corre- 
sponding address of 28 hex. The return address is pushed onto the stack. 
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just as for a regular subroutine call. Subsequent execution of a return instruc- 
tion will cause the program flow to return to the instruction immediately 
following the RST 5 instruction. 

Hardware interrupts operate by emulating the software RST call. When 
an interrupt occurs, the CPU automatically disables the interrupt flip-flop, 
thus further interrupts are prevented. Then a subroutine call is made to the 
corresponding call address. This is done by jamming the desired RST code 
onto the data bus. The simplest implementation is to use a single interrupting 
device and the RST 7 instruction. (A normal interrupt always performs an 
RST 7.) The interrupting peripheral momentarily changes the state of the 
interrupt-request bus line. For the S-100 bus, this would require that bus line 
73 be pulled to a zero-voltage state from the usual 5-volt level. The CPU 
responds by automatically calling memory address 38 hex. The programmer 
will have previously placed the service routine at this location. The service 
routine will conclude with a command to re-enable the interrupt flip-flop. 
Then a return instruction will be executed. 

The trouble with this simple approach is that the RST 7 call to location 
38 hex interferes with system debuggers because they also use this address. 
Consequently, another interrupt level is more suitable. Unfortunately, a 
single interrupt system always calls the RST 7 location. One solution to this 
problem is to use a vectored interrupt board. A vectored interrupt board 
allows the user to select up to eight separate interrupt levels corresponding 
to the RST to 7 instructions. The disadvantage of this approach is the 
cost, since a vectored interrupt board may sell for several hundred dollars. 

However, there is a low-cost solution. If only one interrupt level is 
required, a single hardware interrupt can be converted from an RST 7 to 
some other level such as an RST 5 by using only two logic gates. The circuit 
shown in Figure 4.1 vdll make the needed translation. The output of the 
two-input NAND gate IC-1 goes low when both of the input lines are high. 
One of these inputs is SINTA, line 96 on the S-100 bus. It is a CPU status 
signal that indicates acknowledgment of the interrupt request. The other 
input is PDBIN, bus line 78. This signal indicates that the data bus is in the 
input mode. 

8T97 
14 [\ 13 



SINTA 



JT 



91 



DI4 



96 



78 



PDBIN 



74L00 



Figure 4.1. Circuit to convert an 8080 interrupt to an RST 5. 



When the output of IC-1 goes low, it turns on the three-state buffer 
IC-2. This pulls the data-input bus line DI4 low. Since the remaining seven 
lines of the data-in bus are high, the CPU will see the value of 



1110 1111 
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Notice that this is the bit pattern for the RST 5 instruction. The result is 
that the CPU executes an RST 5 instruction, by calling address 28 hex. The 
interrupt service routine, or a jump to it, is placed at this address. 



AN INTE RRUPT-DRI VEN KEYBOARD 

We have seen that a printer operates considerably slow^er than a CPU. The 
console keyboard is even slower than the printer, especially if the operator 
is not an expert typist. Conversion to an interrupt-driven keyboard will 
considerably increase the effectiveness of a computer. 

Characters entered on an interrupt-driven keyboard are temporarily 
stored in a memory buffer area. Each time a key is pressed on the console, 
the CPU is interrupted from its current task. The new byte is read and 
placed into the keyboard buffer. The computer then returns to its prior task. 
When the computer needs console input, it gets it from the input buffer, 
rather than from the console itself. 

An interface program, utilizing a keyboard-interrupt approach, is 
shown in Listing 4.1. This program provides the necessary routines for 
interfacing the Lifeboart version of CP/M to a North Star disk system.* The 
portions of the program which specifically utilize the interrupt routines 
begin with a row of asterisks and end with a row of semicolons. 



Computer 


Computer 


Keyboard 


Keyboard 


Buffer 
F406 


pointer 


count 


count 


pointer 


F400 


F402 


F403 


F404 



Figure 4.2. The input buffer and pointers. 



The layout of the memory buffer with its pointers is shovra in Figure 
4.2. The buffer area is arbitrarily chosen to start at the address of F400 hex. 
The location can be anywhere above the CP/M operating system. There is 
only one keyboard buffer, but there are two sets of pointers: one for the 
CPU and one for the keyboard. Two counters are also utilized; one shows 
how many characters have been entered from the keyboard and the other 
shows how many have been read by the computer. Since both sets of pointers 
grow larger, they need to be reset periodically. The two pointers are com- 
pared after each carriage return. If they are the same, then they are both 
reset to the beginning of the buffer. 

Suppose that this interface program is incorporated into your system. 
CP/M might be printing something on the console video screen when a key 
on the console is pressed. A hardware interrupt will occur, causing the com- 
puter to stop its task and call address 28 hex (RST 5). A jump instruction at 
address 28 hex will transfer control to subroutine KEYED. The keyboard 
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Listina 4.1. Interrupt driven keyboard. 

TITLE ' Interrupt CP/M BIOS' 
5 

J <Put today's dste here) 

f LIFEBOAT VERSION WITH OPTION FOR 
) EITHER SINGLE OR DOUBLE DENSITY 

} TERMINAL DEVICES SUPPORTED; 
} 







; CONSOLE 


10 HEX 


CONS 










12 HEX 


lst: 






9 r nUNt 


: MODEM 14 HEX 


PUNI 


0000 




9 

r mLdc. 


cm 1 







FFFF 




1 KUc. 


EQU 


NOT FALSE 


FFFF 




9 

DOUBLE 


EQU 


TRUE 


f DOUBLE DENSITY 


FFFF 


= 


TMT&M 
Xn 1 r\ a f 


EQU 


TRUE 


» INTERR VERSION 






7 


IF 


DOUBLE 








hSIZE 


EQU 


54 


5 DECIMAL K 






£• J. w«3 




MSIZE*1024-200H 








EQU 


BI0S+500H 


4yoo 




OFFSET 




IFOOH-BIOS 








ELSE 


5SINGLE 


DENSITY 






MSI2E 


EQU 


56 








USER 


EQU 


MSIZE*1024-700H 








ENDIF 










TnRYTF 

A U JP 1 IE- 


EQU 


3 


J I/O SETUP 






CR 


EQU 


ODH 


f CARRIAGE RET 






LF 


EQU 


OAH 


^LINEFEED 


oooc 


... 


FFEED 


EQU 


12 


? FORMFEED 


\y w w \j 




CTRC 


EQU 


3 


rx. KILL SCROLL 


0004 




CTRD 


EQU 


4 


>"X)> EMPTY BUFFER 


0011 




CTRQ 


EQU 


17 


■f-Qf SCROLL 






CTRS 


EQU 


19 


•f"Sf FREEZE SCROLL 






} 


IF 


DOUBLE 








f PATCH 


DATE 






D5B1 




ORG 


BIOS- 


lOOH+OBlH 










ELSE 










ORG 


USER- 


600H+0AFH 










ENDIF 






D5B1 


2E4465 




DB 


'.Jan 28j80' ?PATCH DATE 


DBOO 




f 

ORG 


USER 






0010 




f 

CSTAT 


EQU 


lOH 


^CONSOLE STATUS 


0011 




CDATA 


EQU 


CSTAT+1 


» CONSOLE DATA 


0001 




CIMSK 


EQU 


1 


5 INPUT MASK 


0002 




COMSK 


EQU 


r> 


f OUTPUT MASK 


0012 




LSTAT 


EQU 


12H 


JLIST STATUS 


0013 




LDATA 


EQU 


LSTAT+1 


{LIST DATA 


0001 




LIMSK 


EQU 


1 


» INPUT MASK 


0002 




LOMSK 


EQU 


2 


p OUTPUT MASK 


0000 




LNULL 


EQU 





fLIST NULLS 



INPUT AND OUTPUT 57 



0014 


— 


MSTAT 


EQU 


14H 


pMODEM STATUS 


0015 




MDATA 


EQU 


MSTAT+1 


p MODEM DATA 


0040 




MIMSK 


EQU 


40H 


p INPUT MASK 


0080 




HOMSK 


EQU 


80H 


p OUTPUT MASK 






y 

; INITIALIZE PORTS FOR 


COMPUTIME BOARD 


00C4 


_ 


ADATA 


EQU 


0C4H 




00C5 




ACONT 


EQU 


ADATA+1 




00C6 




BDATA 


EQU 


ADATA+2 




00C7 




BCONT 


EQU 


ADATA+3 








? 








IF 


INTRM 


p INTERRUPTS 


0095 


— 


STOP 


EQU 


95H 


pSet for INTERR 






t CONSOLE INPUT 


-BUFFER 


LOCATION 


Art 




y 

BUFFER 


EQU 


0F400H 


p INPUT BUFFER 


F400 


- 


CPNTR 


EQU 


BUFFER 


p COMPUTER POINTER 


F402 


= 


CCNT 


EQU 


CPNTR+2 


p BUFFER COUNT 


F403 




KCNT 


EQU 


CCNT+1 


p'KEYBRD BUFF COUNT 


F404 




KPNTR 


EQU 


KCNT+1 


p KEYBOARD POINTER 


F406 




BUFF 


EQU 


KPNTR+2 


5 INPUT BUFFER 


0005 




LEV 


EQU 


. 5 


p INTERR LEVEL 








ENDIF 




p INTERRUPTS 






5 ? 7 p 7 ? y 


pfpppppp 


ppppfppp 


PPPPPPPPPPPPPPPPPP 






p 

START J 








DBOO 


C3i5nB 




JMP 


INIT 


> INITIALIZATION 


DB03 


CXABUB 




JMP 


CONST 


? CONSOLE STATUS 


DB06 


C3D3riB 




JMP 


CON IN 


f CONSOLE INPUT 


DBO? 


C312nC 




JMP 


CONOUT 


p CONSOLE OUTPUT 


DBOC 


C326IIC 




JMP 


LOUT 


pLIST OUTPUT 


DBOF 


C348DC 




JMP 


PUNCH 




DB12 


C3D3DB 




JMP 


CONIN 


pFor reader 






i INITIALIZATION ROUTINES 


DB15 


3E03 


r 

init: 


MVI 


Ap3 




DB17 


D310 




OUT 


CSTAT 


PRESET 


DB19 


03 12 




OUT 


LSTAT 


p INTERFACE 


DBIB 


3E1S 




MVI 


Ay 15H 




DBID 


D312 




OUT 


LSTAT 










IF 


INTRM 




DBIF 


3E95 




MVI 


A p STOP 


pSET for INTERR, 








ENDIF 






DB21 


D310 




OUT 


CSTAT 


p INTERFACE 






9 

p COMPUTIME BOARD INITIALIZATION 


DB23 


AF 


f 


XRA 


A 


pGet a zero 


DB24 


D3C5 




OUT 


ACONT 




rrB26 


ri3C7 




OUT 


BCONT 




DB28 


3E70 




MMI 


Ap70H 




DB2A 


II3C4 




OUT 


ADATA 
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DEI2C 3E77 

DH2E D3CA 

nnao 3E14 

riri32 D3C5 

nB34 3E04 

DB3<& D3t:;7 



BB5A C9 



MVI 
OUT 

OUT 

OUT 



A , 77H 

BDATA 

A»14H 

ACONT 

Ai'4 

BCONT 



IF INTRM 
PATCH RST LOCATION TO JUMP TO KEYBB 



n vi 'X ft 


F3 




PI 




5 DISABLE INTERR 


DB39 


3EC3 




MVI 


A»0C3H 


5JMP INSTR 


DB3B 


322800 




STA 


8*LEV 


» PATCH RST 


DB3E 


E5 




PUSH 


H 




DB3F 


215BDB 




LXI 


HfKEYBD 


5 INTERR ENTRY 


DB42 


222900 




SHLD 


8*LEUH 


iJUaP HERE 


nB45 


2106F4 




LXI 


H?BUFF 


f BUFFER ADDR 


DB48 


2204F4 




SHLD 


KPNIR 


? RESET POINTERS 


DB4B 


2200F4 




SHLD 


CPNTR 




BB4E 


210000 




LXI 


HjO 


5 2 ZEROS 


DB51 


2202F4 




SHLD 


CCNT 


?ZERO THE COUNTS 


DB54 


El 




POP 


H 




DB55 


FE 




EI 




r RE-ENABLE INTERR 








END IF 




f INTERRUPTS 








ifitittftii) 










? 
5 


INITIALIZE 


lOBYTE 




DB56 


AF 


f 


XRA 


A 


f RESET lOBYTE 


DB57 


320300 




STA 


lOBYTE 





RET 

f *************************************** 

IF INTRM 

1 INTERRUPT ENTRY FOR KEYBOARD INPUT 



DB5B 


F5 


KEYBD: PUSH 


PSU 




DB5C 


DBIO 


IN 


CSTAT 


5 CONSOLE STATUS 


DB5E 


E601 


AN I 


CIMSK 




DB60 


CA92DB 


JZ 


KEY2 


;not ready 


DB63 


DBll 


IN 


CDATA 


f'CET DATA 


DB65 


E67F 


ANI 


7FH 


fMASK PARITY 






5 CHECK FOR "S? 


"0 SCROLL CONTROL 


DB67 


FE13 


CPI 


CTRS 


5"S 


DB69 


C27FnB 


JNZ 


KEY3 


;no 


DB6C 


DBIO 


KEY4! IN 


CSTAT 


? CHECK KEYBOARD 


DB6E 


E601 


ANI 


CIMSK 


5 READY? 


DB70 


CA6CDB 


JZ 


KEY4 


5 LOOP UNTIL READY 


DB73 


DBll 


IN 


CDATA 


J GET BYTE 


DB75 


E67F 


ANI 


7FH 


5STRIP PARITY 


DB77 


FEll 


CPI 


CTRR 


5 "0? 


DB79 


C2ACDB 


JNZ 


KEY4 


rNO 


DB7C 


C392DB 


JMP 


KEY2 
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nB7F 


E5 


KEY3J 


PUSH 


H 




riB80 


FE04 




CP I 


CTRD 


f EMPTY BUFFER? 




r A o R fi 






IVt To 


f YES 


DB85 


2A04F4 




LHLB 


KPNTR 


5 BUFFER POINTER 


DB88 


77 




MOV 


M?A 


IPUT IT THERE 


DB89 


23 




INX 


H 


rINR POINTER 


JU' JD O M 


\/"fr *7 




QUI ri 


i\r r* 1 K 


P bRVb. rUlNlfc.K 


DB8ri 


2103F4 




LXl 


H?KCNT 


»GET COUNT 


riB90 


34 




INR 


M 


? INCREMENT IT 


DB91 


El 


i 


r Ui 


u 
n 




DB92 


F 1 
r X 


K" C Y ♦ 


D n D 
r ur 


r bU 




DB93 


FB 




EI 






DB94 


C9 


5 


RET 






DB95 


CD9BnB 


KEY6 J 


CALL 


RSETP 


5 RESET POINTERS 


riB98 


C391DB 


} 


JMP 


KEYS 








} RESET 


BOTH 


POINTERS 


TO START 


nB9B 


210000 


r\ *3 c B r » 




M • 




DB9E 


2202F4 




SHLD 


CCNT 


5ZER0 BOTH 


DBA 1 


?1 0AF4 




LXI 


Hf BUFF 




DBA 4 


2204F4 




SHLD 


KPNTR 


? RESET PNTRS 


DBA? 


2200F4 




SHLD 


CPNTR 




DBAA 


C9 




RET 












END IF 




» INTERRUPTS 








> f f f ! ! 




r>tfft>>t>i)t 






5 CHECK 
5 


FOR CONSOLE INPUT READY 




•2 A AT An 

OH Vovv 


CONSTt 


LDA 


lOBYTE 




DBAE 


E602 




ANI 






DBBO 


C2CBDB 




JNZ 


LISST 


?LIST 






r 








IF 


INTRM 








7 CHECK 


INPUT 


BUFFER RATHER THAN KEYBOARD 


DBB3 


E5 




PUSH 


H 




IIBB4 


2A02F4 




LHLD 


CCNT 


5 BOTH COUNTS 


DBB? 


7C 




MOV 


ArH 




DBB8 


95 




SUB 


L 


f DIFFERENCE 


DBB9 


El 




POP 


H 




OBBA 


C8 




RZ 




»N0 INPUT 


DBBB 


E5 




PUSH 


H 




DBBC 


2A00F4 




LHLB 


CPNTR 


5 COMPUTER PNTR 


DBBF 


7E 




MOV 


AfM 


;nEXT CHAR 


DBCO 


El 




POP 


H 




DBCl 


FE03 




CPI 


CTRC 


5"C? 


DBC3 


CAC8DB 




JZ 


QUIT 


?YESf QUIT 



f MAKE CP/M THINK THERE IS NO INPUT 
j SO SCROLLING WON'T BE ABORTED 
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DBC6 AF 
DBC7 C9 



XRA 

RET 



5 GET ZERO 



DBC8 3EFF 
DBCA C9 



DBCB DB12 
DBCD E601 
DBCF C8 
DBDO 3EFF 
nBD2 C9 



DBD3 3A0300 
DBD6 E602 
DBDS C20ADC 



DBDB E5 
DBDC 2A02F4 
DBDF 7C 
DBEO 95 
DBEl CADCDB 
DBE4 F3 
DBE5 2102F4 
IIBE8 34 
DBE9 2A00F4 
DBEC 7E 



DBEIi 23 
DBEE 2200F4 
DBFl FEOD 
DBF3 C203DC 
DBF6 2A02F4 
DBF9 7C 
DBFA 95 
DBFB C201DC 



iifrttiiiiffiififfifitriitiiifffttfiti 



ELSE 
IN 
ANI 
RZ 

ENDIF 



CSTAT 
CIMSK 



5 NOT INTERRUPTS 
}6ET STATUS 

5 NOT READY 
J INTERRUPTS 



QUIT! 



HVI 
RET 



Af TRUE 

p LIST READY FOR CONSOLE 



f INPUT READY 



LISSTJ IN LSTAT 

ANI LIHSK 
RZ 

MVI ArTRUE 

RET 

i console input 

conin: lda iobyte 

ANI 2 

JNZ LIN 



5 NOT READY 
f READY 



5 LIST INPUT 



J *#*#*««*))(*#««*********««********** 

IF INTRM 5 INTERRUPTS 

I GET INPUT FROM KEYBOARD BUFFER 
; INSTEAD OF FROM CONSOLE 



CIN3: 



PUSH 


H 




LHLD 


CCNT 


fBOTH COUNTS 


MOM 


A>H 




SUB 


L 


5SAME? 


JZ 


CIN3 


fKEEP TRYING 


DI 




?hold off 


LXI 


HjCCNT 


5 COMPUTER COUNT 


INR 


M 


5 INCREMENT IT 


LHLD 


CPNTR 


5 COMPUTER PNTR 


MOV 


A»M 


J GET BYTE 


BOTH 


POINTERS 


IF CARR RET FOUND 


INX 


H 


;BUMP POINTER 


SHLD 


CPNTR 


f SAVE IT 


CPI 


CR 


fCARRIABE RET? 


JNZ 


CIN4 


>N0 


LHLD 


CCNT 


5 GET BOTH COUNTS 


MOV 


ArH 




SUB 


L 


5 DIFFERENCE 


JNZ 


CIN5 


J NOT SAME 


BOTH 


POINTERS 


TO ZERO 
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DBFE 


CD9BDB 




CALL 


RSETP 




DC 01 


3E0D 


CIN5! 


MVI 


A>CR 


5 RESTORE CR 


ncos 


El 


CIN4! 


POP 


H 




rico4 


f-B 




EI 




?READY FOR MORE 


ncos 


C9 




RET 














9 9 9 9 9 9 9 


99999999999999999 








ELSE 




5 NO INTERRUPTS 






CIN2J 


IN 


CSTAT 


? CHECK STATUS 








ANT 


CIMSK 










JZ 


CIN2 










IN 


CDATA 


5 GET DATA 








ANI 


7FH 


5 MASK PARITY 








RET 












END IF 




flNTRM 






} 

9 CONS 


OLE INPUT 


FROM LIST 


DC06 


DB12 


LINJ 


IN 


LSTAT 




DC08 


E601 




ANI 


LIMSK 




DCOA 


CA06DC 




JZ 


LIN 




DCOD 


DB13 




IN 


LDATA 




DCOF 


E67F 




ANI 


7FH 




nr 1 1 


Lf 7 




RET 










} CONSOLE OUTPUT 




DC 12 


3A0300 


conout: lda 


lOBYTE 


5 WHERE? 


nci5 


E603 




ANI 


3 




DC 17 


B7 




ORA 


A 






C" o o C" n r* 




JPO 


LIST 




U If Its 




coNw; 


IN 


CSTAT 


p CHECK STATUS 


DC ID 


E602 




ANI 


COMSK 




DCIF 


CAIBDC 




JZ 


CONW 




DC22 


79 




Hoy 


AfC 


pGet byte 








OUT 


CDATA 


5 SEND IT 


DC25 


C9 




RET 










9 

f LIST 


OUTPUT 






DC26 


3A0300 


lout; 


LDA 


lOBYTE 




DC29 


FA40 




ANI 


40H 


PBIT 6 


DC2B 


C21BDC 


5 


JNZ 


CONW 


pCONSOLE OUT 


DC2E 


DB12 


list: 


IN 


LSTAT 


5 CHECK STATUS 


DC30 


E602 




ANI 


LOMSK 




DC32 


CA2EDC 




JZ 


LIST 




nC35 


79 




MOV 


A?C 


pGet byte 


DC36 


D313 




OUT 


LDATA 


?SEND IT 






7 


IF 


LNULL 


■ 



9 NULLS FOR LIST DEVICE 

9 
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ANI 


7FH 










CP I 


CR 










JNZ 


FORM 










MVI 


Cf 










CALL 


LIST 


fl NULL 








CALL 


LIST 


J 2 NULLS 








CALL 


LIST 


f3 NULLS 








JMP 


LIST 


?4 NULLS 








END IF 






DC 38 


FEOC 


t 

FORM 5 


CP I 


FFEED 


5 FORMFEED? 


riC3A 


CO 




RNZ 




rNO 






EMULATE FORMFEED WITH 9 LINES 




per 




PUSH 


B 




DC3C 


010A09 




LXI 


B»900H+LF 


riC3F 


CD2EDC 


LSKIP • 


PA 1 1 


LIST 




DC42 


05 




T'l P K' 

1.1 1/ r\ 


B 




DC 4 3 


C23FDC 




JN2 


L b t\ J. r 




DC46 


CI 




r Ur 


B 




DC 4 7 


C9 














p 

i PUNCH 


OUTPUT 


SENT TO 


MODEM 


DC48 


79 


? 

PUNCH ! 


nUv 


AsC 


5 GET BYTE 


DC49 


E67F 




AM T 
Mix J. 


7FH 




DC4B 


B7 




UKft 


A 


5 NULL? 


DU4C 










5 DON'T SEND 


DC4D 


FEOA 




PP T 


LF 


5 SKIP LINEFEED 


TIP AC 


PCI 




RZ 




DC50 


CD69DC 




CALL 


MOUT 


^SEND 


DC53 


FEOD 




PC* T 


CR 


J WAIT FOR CR 


DC55 


CA5EDC 




JZ 


MODCR 


DC58 


CD74DC 




CALL 


MIN 


; MODEM INPUT 


DC5B 


D311 




OUT 


CDATA 


fSEND TO CONSOLE 


ri Be fi 


PO 




RET 










5 

? SEND 


<CR> TO 


MODEM. 


WAIT FOR ONE BACK- 


DC5E 


CD74DC 


5 

modcr: 


CALL 


MIN 


MO CONSOLE 


DC61 


D311 




OUT 


CDATA 


DC63 


FEOD 




CP I 


CR 


fKEEP TRYING 


DC65 


C25EDC 




JNZ 


MODCR 


DC68 


C9 




RET 










i MODEM 


OUTPUT 






DC69 


DDI 4 


mout; 


IN 


MSTAT 


? CHECK STATUS 


DC6E! 


E680 




ANI 


MOMSK 




DCAD 


CAA9DC 




JZ 


MOUT 




DC70 


79 




MOV 


ApC 


fGET BYTE 


DC 71 


D315 




OUT 


MDATA 


?SEND IT 


DC 7 3 


C9 




RET 










f MODEM 


1 INPUT 
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DC74 nB14 
DC76 E640 
DC78 CA74DC 
nC7B DB15 
DC7D E67F 
DC7F C9 



MINJ 



IN 
AN I 
JZ 
IN 
AN I 
RET 



MSTAT 

MIMSK 

MIN 

HDATA 

7FH 



? CHECK STATUS 



5GET BYTE 
JMASK PARITY 



DC80 313220 
nC88 



DB 



END 



'1-28-80' fyERSION 



SHiribol table 

00C5 ACONT 
D600 BIOS 
0011 CDATA 
DCOl CIN5 
DBAB CONST 
0010 CSTAT 
0013 CTRS 
DC38 FORM 
F403 KCNT 
IIB91 KEYS 
0013 LDATA 
DC06 LIN 
0002 LOMSK 
0015 MDATA 
0080 MOMSK 
4900 OFFSET 
DBOO START 



00C4 ADATA 
F400 BUFFER 

0001 CIMSK 

0002 COMSK 
DC IB CONW 

0003 CTRC 
FFFF DOUBLE 
DB15 INIT 
DB92 KEY2 
DB95 KEY6 
0005 LEV 
DBCB LISST 
DC26 LOUT 
0040 MIMSK 
DC69 MOUT 
DC48 PUNCH 
0095 STOP 



00C7 BCONT 
F406 BUFF 
DBDC CIN3 
DBD3 CONIN 
F400 CPNTR 
0004 CTRD 
0000 FALSE 
FFFF INTRM 
DB7F KEY3 
DB5B KEYBD 
OOOA LF 
DC2E LIST 
DC3F LSKIP 
DC74 MIN 
0036 MSIZE 
DBC8 QUIT 
FFFF TRUE 



00C6 BDATA 
F402 CCNT 
DC03 CIN4 
DC 12 CONOUT 
OOOD CR 

0011 CTRO 
OOOC FFEED 
0003 lOBYTE 
DB6C KEY4 
F404 KPNTR 
0001 LIMSK 
0000 LNULL 

0012 LSTAT 
DC5E MODCR 
0014 MSTAT 
DB9B RSETP 
DBOO USER 



entry is read with an IN instruction. The byte is then placed into the key- 
board buffer and the buffer pointer and buffer count are both incremented. 
The interrupt flip-flop is enabled with an EI instruction, then the computer 
returns to its previous task. 

When the CPU needs another byte, it gets it from the keyboard buffer 
in memory, rather than from the keyboard itself. The instructions starting at 
subroutine CONIN perform this step. The separate buffer pointer and buffer 
count, maintained for the CPU, are both incremented. 

The interrupt-driven keyboard can be utilized with most of the CP/M 
systems programs. For example, if a BASIC interpreter has been loaded and 
a source program has been entered, then the source program can first be 
listed, then executed by typing the following two lines. 



LIST 
RUN 



The second command can be given immediately following the first, even 
though the first task has not been completed. The second command will not 
be displayed on the console, however, until the completion of the first task. 
Therefore, the operator must type carefully. 
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SCROLL CONTROL AND TASK ABORTION 

Data can appear (scroll) too rapidly on a high-speed video screen. With the 
usual CP/M arrangement, the user can type a Control-S to freeze the video 
display. Typing any other character will cause scrolling to resume. The 
interrupt-driven routine given in Listing 4.1 incorporates its own scroll con- 
trol. Typing a Control-S freezes the screen, just as with the usual CP/M 
setup. However, scrolling can only be resumed by typing a Control-Q. The 
two commands, Control-S and Control-Q, are treated distinctly; they are 
not placed into the input buffer, but are acted upon immediately. 

CP/M tasks are normally aborted by typing any keyboard character. On 
the other hand, a Control-C is required in Microsoft BASIC, and a Control-E 
is used by Xitan BASIC for aborting the current task. This protocol has been 
altered so that characters can be entered into the keyboard buffer during a 
scroll operation. Nevertheless, it may be desirable to abort a task. 

If no characters have been typed ahead, that is, if the computer is 
executing the latest command, then a Control-C command will abort the 
current operation. Alternatively, if there are characters waiting in the console- 
input buffer, then these must be flushed out by typing a Control-D. At this 
point, a Control-C can be typed to abort the task. This arrangement will 
work with most programs, including Microsoft BASIC and Tarbell BASIC. 
If you use Xitan BASIC, then you must change the abort command character 
in the interface routine from a Control-C to a Control-E. 

An additional alteration is necessary for the Word-Master text editor. 
First of all, Word-Master buffers the keyboard buffer using software routines. 
Consequently, a hardware-interrupt system is unnecessary. Secondly, Word- 
Master uses Control-C and Control-D for system commands. Control-C is 
used to display the next screen and Control-D is used to move the cursor to 
the next word. If you want to use hardware interrupts with Word-Master, 
you must change the Control-C and Control-D commands in either the inter- 
face routine or in Word-Master. 



DATA TRANSMISSION BY TELEPHONE 

The process of transmitting information between a peripheral and the com- 
puter may be simple or it may be complex. If the system console is wired 
into the computer, or if the computer itself is built into the console, then 
the integrity of the transmitted data is not likely to be much of a problem. It 
may be, however, that the console is connected to the computer through a 
telephone line. The computer may be located across town or across the coun- 
try. In any case, connection through a telephone line complicates things. 

In a typical telephone arrangement, the data is sent from the console 
by modulating an acoustical carrier for transmission over the telephone line. 
The conversion is performed by an electronic device called a modem (the 
name is an abbreviation for MODulator-DEModulator). Two modems are 
required, one at each end of the telephone line. One converts the transmitted 
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signal to telephone frequencies, the other converts the signal back to the 
original data. 

The modem may also have an acoustical coupler. This allows a standard 
telephone headset to be pressed into two rubber-lined openings in the 
modem, making a direct connection between the modem and the telephone 
line unnecessary. 

There will usually be two data carrier signals at different frequencies. 
This allows simultaneous two-way, or full duplex, operation. The computer 
can transmit data to the console on one carrier while the console is trans- 
mitting data to the computer on the other carrier. 

A microcomputer can produce a more effective link between a console 
and a large main-frame computer, especially if a relatively slow modem is 
utilized. A program can be developed using the microcomputer's editor, 
then the resulting file can be automatically transmitted to the larger com- 
puter. A subroutine that can be used to link a microcomputer to a large 
computer is given in Listing 4.2. This routine can be readily incorporated 
into the system monitor introduced in Chapter 6. 

Listing 4.2 Connection to a Isrsle computer 
f 

9 CONNECT TO ANOTHER COMPUTER 
f THROUGH PHONE MODEM 
f (2-80 CODE) 

9 



0014 






DSTAT 


EQU 


14H 


5STATUS 


0015 






DDATA 


EQU 


DSTAT+1 




0040 






DIMSK 


EOU 


40H 


j INPUT MASK 


0080 






DOMSK 

1 


EQU 


80H 


5 OUT MASK 


0004 






CTRD 


EQU 


4 


r"D7 COPY 


57A1 






TYFLG 


EQU 


STACK+1 


5 COPY FLAG 


5BB3 


AF 




f 

DEC! 


XOR 


A 


jZERO 


5BB4 


32 


57A1 




LD 


(TYFLG) 


fA PRESET COPY 


5BB7 


DB 


14 


decin: 


IN 


A f (DSTAT) J READY? 


5BB9 


E6 


40 




AND 


DIMSK 




5BBB 


28 


13 




JR 


ALTIN 


?N0 


5BBD 


3A 


57A1 




LD 


Af (TYFLG) JCOPY FLAG 


5BC0 


B7 






OR 


A 


fTO MEMORY? 


5BC1 


28 


07 




JR 


ZpDINS 


;no 


5BC3 


CD 


5BF1 




CALL 


DINPUT 


?GET BYTE 


5BC6 


77 






LD 


(HL) f A 


?T0 MEMORY 


5BC7 


23 






INC 


HL 


» POINTER 


5BC8 


18 


03 




JR 


nEC2 




5BCA 


CD 


5BF1 


dins: 


CALL 


DINPUT 


5 GET BYTE 


5BCD 


CD 


5835 


DEC2: 


CALL 


OUTT 


fTO CONSOLE 


5BD0 


CD 


5827 


altin; 


CALL 


INSTAT 


f CONSOLE 


5BD3 


28 


E2 




JR 


ZjDECIN 


fNOT READY 


5BD5 


CD 


581A 




CALL 


INPUT2 


f CONSOLE 


5BD8 


FE 


04 


ALT2J 


CP 


CTRD 


5 "D 


5BDA 


28 


lA 




JR 


Z»DCOPY 


f SET FLAG 



66 8080/Z-80 ASSEMBLY LANGUAGE 



5BDC 


CD 


5BE1 


ALTS J 


CALL 


DECOUT ?T0 DEC 


oBBr 


Id 


TTl Z 

116 




JR 










f OUTPUT A BYTE 


TO DEC 


5BE1 


F5 




decout; 


PUSH 


AF 


5BE2 


CD 


5BEA 




CALL 


DORDY 


5BE5 


Fl 






POP 


AF 






J. tj 




OUT 


( DDATA ) ? A 


5BE8 


18 


CD 




JR 


DECIN JNEXT 








} DEC INPUT READY 


5BEA 


DB 


14 


dordy; 


IN 


A» (DSTAT) 




CIO 


fin 




AND 


DOMSK 


5BEE 


28 


Fl 




JR 


Zf DECOUT 


5BF0 


C9 






RET 










5 

f INPUT 


FROM DEC MODEM 


5BF1 


DB 


15 


? 

DINPUTJ 


IN 


A» <DDATA) 


5BF3 


E6 


7F 




AND 


DEL ;mask parity 


5BF5 


C9 






RET 










5 SET DEC COPY 


FLAG. START COPYING 








5 INTO 


MEMORY AT 100 HEX 


5BF6 


21 


0100 


t 

DCOPYJ 


LD 


HLrlOOH 


5BF9 


3E 


01 




LD 


Arl 


5BFB 


32 


57A1 




LD 


(TYFLG) f A 


5BFE 


18 


B7 




JR 


DECIN 



END 



START 



PARITY CHECKING 

Parity checking provides a method of monitoring the integrity of data trans- 
mission. While there are several different schemes for digitally encoding the 
common characters, the ASCII method is frequently used for microcom- 
puters. The ASCII code, shown in Appendix A, requires only seven bits for 
each character. Since each byte of data contains eight bits, there is one bit 
available for use as a check bit. 

Consider the 7-bit pattern for the ASCII characters 2 and 3. 

ASCII 2 Oil 0010 
ASCIIS Oil 0011 

The value of 2 is encoded with four logical zero bits and three logical 1 bits. 
The value of 3 is encoded with three logical zero bits and four logical 1 bits. 
A parity check can be obtained by including an additional bit on the left 
(high-order) end. 
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There are two common methods of generating the parity bit. One 
encoding method is called even parity. In this case, a leading zero bit is 
added if there are an even number of logical ones among the other seven 
bits. On the other hand, the parity bit would be a logical 1 if there are an 
odd number of logical ones among the other seven bits. With even parity 
coding, the ASCII characters 2 and 3 would look like this. 

2 1011 0010 

3 0011 0011 

Now the 8-bit representation of both the 2 and the 3 contains an even num- 
ber of logical ones (and an even number of logical zeros). 

An alternate approach is called odd parity. In this case, the operation is 
simply the inverse of even parity. The logic of the parity bit is chosen so that 
the resulting bit pattern contains an odd number of logical ones. Either even 
or odd parity encoding will provide a check on the integrity of the data 
transmission. 

Suppose that during transmission of the character 2, the rightmost bit 
became inverted. The console sent the even-parity bit pattern 

1011 0010 

but the computer received the bit pattern 

1011 0011 

A parity check, performed at the computer, would be able to detect the fact 
that there was an error. 

A typical console-input routine might look like this. 



IN 


CMASK 


? CHECK STATUS 


AMI 


CIMSK 


5 MASK FOR INPUT 


JZ 


CONIN 


5 LOOP UNTIL READY 


IN 


CDATA 


pGET THE DATA 


ANI 


7FH 


5REM0VE PARITY 


RET 







The next to the last instruction in this subroutine performs a logical AND 
with 7F hex. This step is used to remove the high-order bit of the byte since 
it is not needed for ASCII data. Instead of ignoring this eighth bit, we could 
use it as a parity check. An input routine to perform a check for parity 
looks like the following list. 
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CONINI 



IN 
AN I 

JZ 

IN 

ORA 

JPO 

AMI 

RET 



CMASK f CHECK STATUS 

CIMSK 5 MASK FOR INPUT 

CONIN fLOOP UNTIL READY 

CBATA fBET THE DATA 

A jSET PARITY FLAG 



PERROR 5PARITY ERROR 
7FH pREMOME PARITY 



} PARITY-ERROR MESSAGE 



PERROR J . . . 

This routine is essentially the same as the one given immediately before, but 
after the data register has been read by the computer, the parity of the byte 
is determined. 

The ORA A instruction performs a logical OR of the accumulator with 
itself. A logical OR of any byte with itself will not change the byte. How- 
ever, it does affect the status flags in this case. After the OR operation, the 
parity flag will be set according to the parity of the accumulator. If the 
parity is found to be odd, then an error is present. The JPO instruction 
causes a jump to the parity-error routine in this case. However, if the parity 
is found to be even, then the byte in the accumulator does not contain a 
parity error. 

Notice that a parity check will not detect an even number of bit errors 
in a byte. There may be two, four, or six errors, and the parity check will 
not detect an error. This is not likely to be a practical problem, however, 
since the Mkelihood of two errors is much less than the likelihood of single 
errors. 

ASCII computer terminals usually have the ability to automatically 
transmit an eighth parity bit with the data. Furthermore, there will typically 
be a user-selectable switch for choosing either even or odd parity. There may 
also be the additional choices of always resetting or always setting the parity 
bit. The input routine can check for odd parity if the JPO instruction is 
changed to a JPE instruction. 

There are much more sophisticated methods of checking for transmis- 
sion errors. One of these is the checksum approach discussed in Chapter 9. 
With this method, the transmitted data are added together. At regular inter- 
vals, the sum, or its complement, is transmitted along with the data. When 
the data are decoded, the data are added up again and compared to the 
checksum. 

The Hamming error-correction code is even better than the checksum 
method. It not only detects errors, but can also correct them. In the end, 
however, it is wise to find out why errors occur, and to take the appropriate 
action to correct the problem. A dirty tape head, for example, can produce 
errors. Cleaning the head is better than relying on an error-correction 
scheme. 



CHAPTER FIVE 

Macros 



Sophisticated assemblers incorporate a macro processor. A macro is used to 
define a set of instructions which are associated with the macro name. Then 
whenever the macro name appears in the source program, the assembler 
substitutes the corresponding instructions. This is called a macro expansion. 

Suppose that we want to interchange the contents of two memory 
locations with the following instructions. 



LDA FIRST 

PUSH PSW 

LDA SECOND 

STA FIRST 

POP PSW 

STA SECOND 



?GET FIRST BYTE 
5 SAVE 

fGET SECOND 
fPUT INTO FIRST 
»GET FIRST 
5 PUT INTO SECOND 



This set of instructions can be defined in a macro called SWAP. 



MACRO 




rSWAP FIRST AND SECOND 


LDA 


FIRST 


>GET FIRST BYTE 


PUSH 


PSW 


fSAVE 


LDA 


SECOND 


5 GET SECOND 


STA 


FIRST 


fPUT INTO FIRST 


POP 


PSW 


JGET FIRST 


STA 


SECOND 


J PUT INTO SECOND 


ENDM 







The macro definition is placed near the top of the assembler source program. 
The first line defines the macro name; the last line terminates the definition. 
The name SWAP can now be used like an operation code, it is placed in 
the source program whenever the corresponding instructions are needed. 
When the assembler encounters the name SWAP, it substitutes the desired 
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instructions. The final binary code generated by the assembler is the same as 
it would be if the instructions had originally been entered into the source 
program. 

Each time the macro name SWAP appears in the source program, the 
same set of instructions will be generated and the same two memory loca- 
tions will be interchanged. The SWAP macro becomes more versatile if the 
memory locations can be changed. If the names of the memory locations 
are placed on the first line of the macro definition, they become dummy 
variables. 



SWAP MACRO FIRST J 

LDA FIRST 

PUSH PSW 

LDA SECOND 

STA FIRST 

POP PSW 

STA SECOND 
ENDM 



SECOND 
fGEX 1ST BYTE 
$SAVE 
;GET 2ND 
IPUT INTO 1ST 
5 GET 1ST 
fPUT INTO 2ND 



The actual parameters in the macro call are substituted for the dummy 
parameters at assembly time. The macro call 



SWAP HIGH; LOW 

generates the assembly language instructions 



LDA 


HIGH 


fGET 


1ST BYTE 


PUSH 


PSW 


5SAVE 




LDA 


LOW 


SGET 


2ND 


STA 


HIGH 


5 PUT 


INTO 1ST 


POP 


PSW 


fGET 


1 ST 


STA 


LOW 


5 PUT 


INTO 2ND 



The statement 



SWAP LEFT* RIGHT 



will produce the instructions 



LDA LEFT 

PUSH PSW 

LDA RIGHT 

STA LEFT 

POP PSW 

STA RIGHT 



»GET 1ST BYTE 
f SAVE 
fGET 2ND 
5PUT INTO 1ST 
fGET 1ST 
fPUT INTO 2ND 



The structure of macros can be much more complicated than the above 
examples. One macro can be nested inside another. 
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OUTER MACRO 
* » « 

IF FAST 
INNER MACRO 

» * * 

ENDM* > DINNER 

« » * 

ENDIF ) JFAST 

» * « 

ENDM i >OUTER 

Conditional assembly directives can be used to create different versions. 
Comments in the macro definition which begin with a single semicolon are 
reproduced in the macro expansion along with the op codes. But if the com- 
ments are preceded by two consecutive semicolons, then they will appear 
only in the macro definition, not in the macro expansion. 



GENERATING THREE OUTPUT ROUTINES WITH ONE MACRO 

A subroutine can be used whenever a set of instructions is needed at several 
places in a program. But there are times when a similar but different group 
of instructions is needed. A subroutine cannot be used in this case. Consider 
the three 8080 output routines that follow. The first sends a byte to the 
console, the second sends a byte to the list device, and the third sends a byte 
to the phone modem. 



LOT} 



IN 


CSTAT 


ANI 


COMSK 


JZ 


COT 


MOV 


A>C 


OUT 


CDATA 


RET 




IN 


LSTAT 


ANI 


LOMSK 


JZ 


LOT 


MOV 


AfC 


OUT 


LDATA 


RET 




IN 


MSTAT 


ANI 


MOMSK 


JNZ 


MOT 


MOV 


A>C 


OUT 


MDATA 


RET 





The structure of these three routines is very similar. Each begins by 
reading the appropriate status register. Then a logical AND is performed to 
select the output-ready bit. Looping occurs until the peripheral is ready. The 
byte is moved from the C register into the accumulator and sent to the 
appropriate peripheral. Finally, a return instruction is executed. 
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These three routines are sUghtly different, hence they cannot be re- 
placed by a single subroutine. However, since they have similar structure 
they can be generated with a macro. The macro definition looks like this. 



OUTPUT MACRO 
TSSOTf IN 

mi 

JI?Z 

MOV 

OUT 

RET 

ENDH 



?Sf ?Z 
TS8STAT 



fOUTPUT ROUTINES 
? CHECK STATUS 



TSSOMSK fMASK FOR OUTPUT 



?S80T 
ArC 



f NOT READY 
>GET BYTE 



TS8DATA fSEND IT 



It would appear near the beginning of the source program. The macro name 
chosen is OUTPUT and the two dummy g^rguments are ?S and ?Z. Dummy 
arguments can have the same form as any other identifier. A question mark 
was chosen as the first character so that the dummy arguments would be 
easier to find in the macro definition. You must be careful not to use register 
names such as A, B, H, or L for dummy arguments if these register names 
also appear in the macro. 

Each of the three output routines is generated by a one-line macro call. 

OUTPUT CrZ f CONSOLE OUTPUT 

f 

OUTPUT L»Z fLIST OUTPUT 

OUTPUT MfNZ f MODEM OUTPUT 



Each line includes the appropriate parameters. At assembly time, the real 
arguments replace the dummy arguments of the macro. The ampersand 
character (&) is a concatenation operator. It separates a dummy argument 
from additional text. The macro processor substitutes the real parameter for 
the dummy argument, then joins it to the rest of the text. By this means the 
expression ?S&OT becomes LOT if the real argument is the letter L. 

Macro assemblers may give the user three options for the assembly 
listing: 

1. Show the macro call, the generated source line, and the resultant 
hex code. 

2. Show the macro call and the hex code. 

3. Show only the macro call. 

If option 1 is chosen, then the above three macro calls to OUTPUT will pro- 
duce the following. 
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UUTrUT 


nHCRu 


fa f XL 


fOUIrUl hiuuixr(t.b 




?S80Tt 


IN 


TS8STAT 


* CHECK STATUS 






ANI 


TS80MSK 


?MASK FOR OUTPUT 






J8?Z 


?S80T 


SNOT READY 






MOV 


A»C 


rGET BYTE 






OUT 


TS8DATA 


5 SEND IT 






RET 










ENDM 








f 


OUTPUT 


C»Z 


.CONSOLE OUTPUT 


4000-fDBlO 


cot: 


IN 


CSTAT 


5CHECK STATUS 


4002-fE602 




ANI 


COMSK 


5 MASK FOR OUTPUT 


4004+CA0040 




JZ 


COT 


5 NOT READY 


4007+79 




MOV 


AfC 


fGET BYTE 


4008+D311 




OUT 


CDATA 


fSEND IT 


400A+C9 




RET 








} 


OUTPUT 


L^Z 


SLIST OUTPUT 


4006+08 12 


LOT? 


IN 


LSTAT 


p CHECK STATUS 


400D+E602 




ANI 


LOMSK 


JMASK FOR OUTPUT 


400F+CA0B40 




JZ 


LOT 


f NOT READY 


4012+79 




MOV 


AfC 


JGET BYTE 


4013+D313 




OUT 


LDATA 


5 SEND IT 


4015+C9 




RET ' 








? 


OUTPUT 


M^NZ 


j MODEM OUTPUT 


4016+nB14 


MOTf 


IN 


MSTAT 


? CHECK STATUS 


4018+E680 




ANI 


MOMSK 


fMASK FOR OUTPUT 


401A+C21640 




JNZ 


MOT 


fNOT READY 


40iD+79 




MOV 


A»C 


SQET BYTE 


401E+D315 




OUT 


MDATA 


SSEND IT 


4020+C9 




RET 







The first argument in the macro, ?S, is replaced by the actual argument. This 
is the letter C in the first call, the letter L in the second call, and the letter M 
in the third call. The second argument is used to select a JZ or JNZ instruc- 
tion for the third line of the macro expansion. 

Some assemblers automatically remove the ampersand symbol from the 
resultant assembly listing. Others leave the symbol in place. In this latter 
case, the first line of the first routine would look Uke this. 

C80TI IN C8STAT ? CHECK STATUS 

But this is a matter of style. The actual machine code generated is the same 
in either case. 



GENERATING Z-80 INSTRUCTIONS WITH AN 8080 ASSEMBLER 

If you have a Z-80 CPU but an 8080 macro assembler, such as the Digital 
Research MAC, you can run all of the 8080 programs just as they are given 
in this book. You can also do the Z-80 programs by using macros to generate 
the Z-80 instructions. For some of the instructions, the regular Zilog mne- 
monic can be used. For other instructions a slightly different format is 
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necessary. Consider, for example, the Z-80 instruction that performs a two's 
complement on the accumulator. The Zilog mnemonic for this operation is 
NEG. A Z-80 assembler converts this mnemonic into the two hex bytes 
ED 44. With an 8080 macro assembler you can use the same mnemonic. 
Define the macro 

NEG MACRO t TWO'S COMPLEMENT 

DB OEDHf 44H 

ENDM 

Then, the macro call 
NEG 

is placed in the source program when the Z-80 NEG instruction is needed. 
The 8080 macro assembler will insert the desired hex bytes ED 44 at this 
point. 

As another example, consider the Z-80 relative-jump instruction. This 
instruction can be implemented with a macro that uses the assembler's pro- 
gram counter, a dollar sign. The macro definition looks like this. 

JR ADDR ; RELATIVE JUMP 

DB 18Hf ADDR-»-l 

ENOH 

The dummy parameter ADDR is the destination address of the jump. The 
macro call 

JR ERROR 

will generate the correct Z-80 code. The first byte will be 18 hex. The 
second byte will be the required displacement for the jump. 

The Z-80 instruction, DJNZ, can be generated in a similar way. This 
instruction decrements the B register and jumps relative to the address of 
the argument if the zero flag is not set. The macro definition is 

DJNZ MACRO ADDR 

DB 10HjADDR-$-1 
ENDM 

and the macro call looks like 
DJNZ LOOP 

This approach will work with most macro assemblers. There may be a prob- 
lem, however, with the interpretation of the dollar sign. This symbol usually 
refers to the address of the beginning of the current instruction. But for 
some assemblers, it is interpreted as the address of the following instruction. 
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If your assembler uses the latter interpretation, you will have to change the 
macro accordingly. If in doubt, check the user manual. 

Some Z-80 mnemonics are not compatible with the macro format. For 
example, the Z-80 instruction 

PUSH IX 

cannot be generated with a macro called 

PUSH MACRO REO 

since PUSH is a regular 8080 mnemonic. One possibility is to name the 
macro PUSHIX instead. 

PUSHIX MACRO 

DB ODDHi-OESH 
ENDM 

Similar problems occur with the commands POP IX, ADD IX,BC, SUB 
(IX+dis), and SET. A format that is different from the Z-80 mnemonic must 
be chosen in each of these cases. 

The Digital Research macro assembler has an added bonus. Frequently- 
used macros can be placed into a separate macro library and given the file 
extension of LIB. In fact, this assembler is supphed with a macro library 
called Z80.LIB that will generate all of the Z-80 instructions. The statement 

MACLIB Z80 

is placed near the beginning of the regular source program. The assembler 
will then look in the file Z80.LIB for the required macros. 



EMULATING Z-80 INSTRUCTIONS WITH AN 8080 CPU 

The Z-80 CPU can execute many powerful instructions that are not available 
to the 8080. Some of these useful instructions are difficult to implement on 
an 8080, while others are simply combinations of regular 8080 instructions. 
The NEG instruction is one of the easiest to implement. The macro defini- 
tion is 

NEB MACRO 58080 TWO'S COMPLEMENT 

CMA ffi'S COMPLEMENT 

INR A i »2'S COMPLEMENT 

ENDM 

Now, whenever a two's complement is needed, the macro call 
NEG 
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is placed into the program. The assembler generates the required 8080 
mnemonics 



CHA 

INR A 



Another useful Z-80 operation is the arithmetic shift. This operation 
shifts all bits of a register one position to the left. The high-order bit is 
moved into carry, that is, the carry flag is set to a 1 if bit 7 was originally a 
value of 1. The carry flag is reset to zero if bit 7 was zero. A value of zero is 
placed into the low-order bit (bit zero). 

The 8080 instruction ADD A, which adds the value in the accumulator 
to itself, performs the arithmetic shift left. But for the 8080, this is the only 
register which can perform the shift. The Z-80 has an additional instruction 
which allows this operation to be performed on any of the general-purpose, 
8-bit registers or on the memory byte referenced by HL, IX, or lY. 

The following macro will generate a set of 8080 instructions for the 
arithmetic shift left operation. 



SLA MACRO REB f SHIFT LEFT ARITH 

MOV ArREG 5 5GET BYTE 

ADD A f »SHIFT LEFT 

HOM REGrA ) fPUT BACK 
ENDM 



The byte is first moved to the accumulator. The next step is to add the 
accumulator to itself. This doubling operation performs the needed shift 
into carry. Then the result is returned to the original register. The value in 
register C can be doubled by inserting the macro call 

SLA C 



This macro must be used with caution, since the accumulator will be 
changed during use. But the byte originally in the accumulator cannot be 
saved with a PUSH PSW instruction. The problem is that the subsequent 
POP PSW command will overlay the flag register, so that the carry result of 
the shift will be lost. One solution is to save the accumulator in memory. 



MACRO 


REG 


9 


SHIFT LEFT ARITH 


STA 


SAVE 


P 


fSAVE A 


MOV 


Af REG 




;get byte 


ADD 


A 


f 


f SHIFT LEFT 


MOV 


REGf A 




»put back 


LDA 


SAVE 


t 


» RESTORE A 


ENDM 
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THE REPEAT MACROS 



There are times when several lines of identical or nearly identical lines of 
code are needed. Three repeat macros, REPT, IRP, £ind IRPC are provided 
for this purpose. The repeat macros differ from the regular macros in that 
they are placed directly into the source program where they are needed. The 
macro definition is the macro call. In the simplest form, an instruction or 
group of instructions can be replicated. The expression 



REPT 4 

RAR 

ENDM 



will generate the four lines 



RAR 
RAR 
RAR 
RAR 



By using the SET directive, this operation can become more versatile. The 
SET instruction is like an EQU except that the value can be redefined. 
The lines 



ADDR SET 8000H 

REPT 4 

ADDR SET ADDR+3 

DW ADDR 

ENDM 



will generate the code corresponding to 



DW 8003H 

DU 8006H 

DM 8009H 

DW 800CH 



Such a series could refer to jump vectors that are spaced three bytes apart. 

The repeat macro, combined with the conditional-assembly directive, 
can generate the required number of nulls after a carriage-return, line-feed 
pair. This will give the printer time to return to the left margin. Some 
printers need no nulls, whereas others may need as many as six or seven. The 
source code could be 



$ OUTPUT TO LIST DEVICE 



lout: 



IN 

AN I 
JZ 
MOM 
OUT 



LSTAT 

LOMSK 

LOUT 

AcC 

LDATA 



fGET DATA 
jSEND BYTE 
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IF 


NULLS > 





ANI 


7FH 


J REMOVE PARITY 


CPI 


CR 


; CARRIAGE RETURN? 


RNZ 




$N0 


mi 


CtO 


J GET A NULL 


REPT 


NULLS 


SHOW MANY? 


CALL 


LOUT 


)SEND NULL 


ENDM 




S REPEAT MACRO 


ENDIF 




1 NULLS 


RET 







The first part is a typical output subroutine. A call is made with the byte in 
register C. When the output device is ready, the byte is moved from the C 
register to the accumulator. It is then sent to the printer. If no nulls are 
required, then the passage from 

IF NULLS > 

to 

ENDIF 

is not assembled. On the other hand, if nulls are required, then this passage 
is assembled. If four nulls are needed, then the assembler will generate four 
lines of 

CALL LOUT 5 SEND NULL 

The list output routine calls itself to produce the required nulls. The identi- 
fier called NULLS must be previously set to the necessary number of nulls. 

There are two other repeat macros called IRP and IRPC. A set of one- 
character message routines can be generated by using the indefinite repeat 
macro IRPC. This example will introduce something called a programming 
trick. Some people think that it is a horrible example of programming. 
Others think it is very clever. Its purpose is to save two bytes of instruction 
each time it is used. In addition, less branching is required. 

Suppose that we need five different message routines that each produce 
a single character. The instructions might look like 



CHARC; 


MVI 


A» 'C 




JMP 


OUTT 


CHARM : 


MVI 


A» 'M' 




JMP 


OUTT 


CHARR t 


MVI 


Ar 'R' 




JMP 


OUTT 


CHAR?: 


MVI 


A» '?' 




JMP 


OUTT 


CHAR« : 


MVI 


A> 




JMP 


OUTT 



OUTT J 



» * * 

<outFut routine> 
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If the B and C registers are not in use, we can shorten the above passage by 
replacing each line containing the instruction JMP OUTT with a line of DB 1. 



CHARC5 


MVI 


A> 


'C 




DB 


1 




charm: 


mi 


A» 


'M 




DB 


i 




charr: 


MM I 


Ar 


'R 




DB 


1 




CHAR?: 


MVI 


An 


'? 




DB 


1 




CHAR*: 


mi 


A; 


'$ 


OUTT J 


« * « 







Let's'see how this works. Suppose that a branch is made to the label 
CHARC. The accumulator is loaded with an ASCII letter C. The next byte, 
a DB 1, looks like the start of an LXI B instruction. The following two 
bytes, corresponding to the MVI A,'M' instruction, will be interpreted as the 
argument for the LXI instruction. That is, they will be considered as data. 
The same will hold for the other occurrences of DB 1. By this means, we 
have effectively shortened the code. We no longer need the JMP statements. 
Caution: a disassembler is not likely to interpret this passage correctly. It 
looks like there are labels pointing into the middle of the LXI instructions. 
Notice that the second version has subroutine OUTT positioned directly 
under the CHAR$ routine, so that no JMP instruction is needed at this 
point. 

The second version can be easily generated with the IRPC macro. Only 
five lines are needed in the source program. 

IRPC XfCMPRT* 
DB 1 5FAKE LXI B 

CHARSX: MVI Af'SX' 
ENDM 

The five different message routines are all generated with this single macro. 
One replication is made for each character of the second argument to IRPC. 



PRINTING STRINGS WITH MACROS 

Suppose that we want to send messages to the console from various points 
of a program. We could write a subroutine called SENDM for this purpose. 



SENDMI 



LDAX 


D 


?GET CHAR 


ORA 


A 


?ZERO? 


RZ 




lYES 


INX 


D 


^POINTER 


MOV 


Cf A 




CALL 


OUTT 


PSENT 


JMP 


SENDM 


INEXT 
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The address of the message is loaded into the DE register and subroutine 
SENDM is called. 

LXI DfMESSl 
CALL SENDM 

Subroutine SENDM prints a message by sending each character to the output 
subroutine OUTT. When a binary zero, used to indicate the end of the mes- 
sage, is found, SENDM returns to the calling program. 

We can simplify the sending of messages by using a macro called PRINT. 
At each point we write 

PRINT <CHECKSUM ERROR> 

» « « 

PRINT <ENB OF FILE> 
PRINT <OUTPUT TO LIST?> 

The macro called PRINT will generate the message given in the argument. 
The message is enclosed in angle brackets because the blanks are part of the 
argument. 

If subroutine SENDM were placed into the macro body, then one copy 
of SENDM would be inserted for each occurrence of the PRINT statement. 
But we don't need more than one copy of SENDM. On the other hand, if 
we don't include SENDM in the macro, there may not be any copies at all. 
What we need is a mechanism for inserting one, and only one, copy of 
SENDM regardless of how many times we give the PRINT command. 

The solution is to write a double macro— one nested inside the other. 
Both macros will be given the same name. Subroutine SENDM will be part 
of the outer macro which will be expanded only once. The layout looks 
like this. 

PRINT MACRO <«»ess3ae> ? OUTER MACRO 

ft « » 

[define SENDM. 1 

t * 9 

PRINT MACRO <»ess3ae> f INNER MACRO 
« * « 

Csend nesssste] 

ENDM f INNER MACRO 

ENDM f OUTER MACRO 

The source program in Listing 5.1 demonstrates this technique. The outer 
macro PRINT has the argument ?TEXT, used for the first call to the macro. 
Subroutine SENDM is generated at this time. Additional macro calls to 
PRINT utilize the inner macro which has the argument ?TEXT2. Subrou- 
tine SENDM is not generated on these subsequent calls. 



Listina 5.1. Source listing for 3 macro 
demonstration prosiram. 

f 

PRINT MACRO ?TEXT 
LOCAL AROUND 

JMP AROUND JSENDH 

f 

t SUBROUTINE TO SEND A STRING TO 

i THE CONSOLE. BINARY ZERO AT STRING END. 

» D»E IS STRING POINTER. 



SENDMJ 


LDAX 


D 


?OET CHAR 




ORA 


A 


fZERO? 




RZ 




pYES 




INX 


D 


; POINTER 




MOM 


CfA 






CALL 


OUTT 


fSENT 




JMP 


SENDM 


pNEXT 


around: 








i REDEFINE THE 


MACRO 




y 

PRINT 


MACRO 


TTEXT2 






LOCAL 


MESG 7 CONT 


1 


PUSH 


n 


pSAVE DpE 




LXI 


DfMESG 


; POINT 




CALL 


SENDM 






POP 


D 


J RESTORE 




JMP 


CONT 


5 SKIP MESSAGE 


MESG : 










DB 


CR»LF» ' 8TTEXT2' f 


cont: 


EN DM 




j INNER MACRO 




PRINT 


<?TEXT> 






ENDM 




» OUTER MACRO 


CSTAT 


EQU 


lOH 


? CONSOLE STATUS 


CDATA 


EQU 


CSTAT+1 


> CONSOLE DATA 


CR 


EQU 


13 


J CARRIAGE RETURN 


LF 


EQU 


10 


{LINE FEED 


ORG 


lOOH 






START! 










PRINT 


<CHECKSUM ERROR. > 


f 


PRINT 


<END OF 


FILE.> 


7 


PRINT 


<OUTPUT 


TO LIST'i*> 




JMP 





{RETURN TO CP/M 



; SEND CHARACTER IN C TO THE CONSOLE 
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OUTTS IN CSTAT 
ANI 2 
JZ OUTT 
MOV A?C 
OUT CDATA 
RET 

} 

END 



Subroutine SENDM is coded into the main flow of the program, that 
is, it is an inline routine. It is therefore necessary to jump around SENDM. 
Additionally, there must be a branch around each of the messages, since they 
too are coded inline. Labels for the required branches are uniquely gener- 
ated in the macro by declaring the corresponding labels as LOCAL. The 
resulting assembly listing is given in Listing 5.2. The assembler places plus 
symbols between the address and the generated code of the assembly listing 
to designate those lines that were generated by macros. Thus, lines that 
contain plus symbols were not present in the original source listing. 



Listina 5,2. 



Assembly listing 
demonstration p 



for 3 mscro 
roSram . 



PRINT 



MACRO 
LOCAL 



?TEXT 
AROUND 



JMP 



AROUND 



; SENDM 



» SUBROUTINE TO 
; THE CONSOLE. 
5 BfE IS STRING 



SEND A STRING TO 
BINARY ZERO AT STRING END. 
POINTER. 



SENDM! 



LDAX 

ORA 

RZ 

INX 

MOV 

CALL 

JMP 



D 
A 

D 

CfA 

OUTT 

SENDM 



IGET CHAR 
rZERO? 

5 YES 

^POINTER 

fSENT 
fNEXT 



around; 



5 REDEFINE THE MACRO 



PRINT 



MACRO 
LOCAL 



TTEXT2 
MESGfCONT 



PUSH D fSAVE DrE 

LXI DfMESG » POINT 

CALL SENDM 

POP D JRESTORE 

JMP CONT fSKIP MESSAGE 



MESG! 



DB 



CR»LFr'»?TEXT2' fO 
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rnMT * 


C.r«lin 


flNNthl nACKO 






PRINT 


<?TEXT> 






ENDM 


» OUTER MACRO 


0010 = 


f 

OSTAT 


EQU 


lOH fCONSOLE STATUS 


0011 = 


CDATA 


EQU 


CSTAT+1 ^CONSOLE DATA 


OOOD = 


OR 


EQU 


13 ^CARRIAGE RETURN 


OOOA = 


LF 
5 


EQU 


10 JLINE FEED 


0100 


ORG 


lOOH 






START? 










PRINT 


<CHECKSUM ERROR . > 


0100-fC30E01 




JMP 


??0001 rSENDM 


0103+lA 


SENDMS 


LDAX 


D J GET CHAR 


0104+B7 




ORA 


A JZERO? 


01054-08 




RZ 


; YES 


0106+13 




INX 


D fPOINTER 


0107+4F 




MOV 


Cf A 


0108+CD6501 




CALL 


OUTT f SENT 


010B+C30301 




JMP 


SENDM fNEXT 


010E+D5 




PUSH 


D 5SAVE DifE 


OlOF+111901 




LXI 


Df??0002 5 POINT 


O112+C0O3O1 




CALL 


SENDM 


0115+Dl 




POP 


D ; RESTORE 


0116+C32B01 




JMP 


??0003 5 SKIP MESSAGE 


0119+0n0A434845 


1 


OB 


CRfLFf 'CHECKSUM ERROR. ' » 




9 


PRINT 


<END OF FILE.> 


012B+D5 




PUSH 


D fSAVE D»E 


012C+113601 




LXI 


Df??0004 5P0INT 


012F+CD0301 




CALL 


SENDM 


0132+Dl 




POP 


D 5 RESTORE 


0133+034501 




JMP 


??0005 jSKIP MESSAGE 


0136+0n0A454E44 




DB 


CR>LF> 'END OF FILE. ' ,0 




V 


PRINT 


•COUTPUT TO LIST'i"":' 


0145+05 




PUSH 


D 5 SAVE D.E 


0146+115001 




LXI 


Di-??0006 IPOINT 


0149+CD0301 




CALL 


SENDM 


014C+Di 




POP 


D ; RESTORE 


014D+C36201 




JMP 


??0007 rSKIP MESSAGE 


0150+OnOA4F5554 




DB 


CRrLFr 'OUTPUT TO LIST?' »' 


0162 C30000 




JMP 


> RETURN TO CP/M 




P 

f O (C JL* 


CHARACTER IN C TO THE CONSOLE 


0165 DBIO 


f 

OUTTJ 


IN 


CSTAT 


0167 E602 




ANI 


2 


0169 CA6501 




JZ 


OUTT 


016C 79 




MOV 


As C 


016D D311 




OUT 


CDATA 


016F 09 




RET 




0170 




END 
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If you are familiar with the operation of your assembler, type up the 
demonstration program and try it out. Branch to the beginning and three 
messages will appear at the console. 

Checksuin error 
End of file 
Output to list? 

Assembler operation will be considered in the next chapter. 

By constructing increasingly complicated macros, it is possible to 
develop some of the structure that is characteristic of higher-level languages 
such as Pascal. The common loop constructions 

REPEAT 

4 9* 
* * * 

UNTIL <condition true> 

and 

LOOP 
« » » 

EXITIF <condition true> 
ENDLOOP 

can be realized with macros called REPEAT, UNTIL, and so on. The argu- 
ments to UNTIL and EXITIF will consist of three terms. The first and third 
will be numeric values. The middle term will represent a logical operation 
such as EQUALS or LESS THAN. The spelling of the logical operators in 
this case will have to be unusual, since the normal spellings 

EQ 
LT 
GE 

are already utilized by the macro assembler. Macros for all of the common 
structures are available commercially. Also, source programs for structured 
macros of this type may be given in the instruction manual for your macro 
assembler. 



CHAPTER SIX 

Development of 
a System Monitor 



The best way to learn assembly language programming is to actually do it. 
Consequently, in this chapter you will develop a small but very powerful 
utility program called a monitor. There are many useful things that can be 
done with the monitor. There is a command to examine memory and another 
to change it. Other commands deal with memory blocks. These allow you to 
move a block from one location to another. Some of the features will dupli- 
cate those found in other programs, but other features, such as a search 
routine and a memory test routine, will be unique. 

You will not program the entire monitor at one time. Instead, you will 
start with just the bare essentials. You will check the monitor after each 
major change to ensure that the new features have been added correctly. 
With this so-called top-down method, any error that develops is likely to be 
found in the most recently added instructions. As new features are incorpo- 
rated, the monitor will increase in size until it reaches IK bytes. This is a 
size that can be easily programmed into a single ROM. The monitor will 
then be immediately available as soon as the computer is turned on. 

An editor and an assembler are required for the development of the 
monitor. In addition, a debugger will be helpful if you have problems along 
the way. Each phase of the development will require the same sequence of 
steps. 



1. Generate an assembly language source file with the editor. 

2. Assemble the source program to produce an object file. 

3. Compare the hex code from your assembly listing to the listing 
given in this chapter. 

4. Load the object program into memory. 

5. Branch to the monitor and try it out. 
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The assembly listings given in this chapter are written with 8080 mne- 
monics. You can use an 8080 assembler for these programs whether you 
have an 8080 or a Z-80 CPU. The resulting code will run on both an 8080 
and a Z-80 CPU. If you have only a Z-80 assembler, you will have to change 
the mnemonics. The cross-reference between the 8080 and Z-80 mnemonics, 
given in Appendix G, can be used to find the corresponding instructions. 
Alternately, you can define the 8080 mnemonics as macros. 

PROGRAM DEVELOPMENT DETAILS 

This section describes the details of program development. Skip to the next 
section if you are familiar with the operation of your editor and assembler. 
An editor is needed to create and alter the assembly language source file. If 
you have CP/M, you will have an editor called ED. Other editors, such as 
ED-80, EDIT80, and Word-Master, are separately available. 

The session begins by giving the name of the editor and the name of the 
source program. The following discussion assumes that you have CP/M. If 
you have some other operating system, the approach will be similar, but the 
details may differ. Put the CP/M system diskette in drive A and a working 
diskette in drive B if you have more than one drive. Go to drive B with the 
command 

A>BJ 

The response will be 
B> 

Type the name of the editor followed by the name of the monitor source, 
program. The command line might look hke this. 

b>a:ed MONi . ash 

for the first version. The digit 1 in the filename refers to the version number. 
The file type is ASM for the Digital Research assemblers ASM and MAC. 
The file type should be chosen as MAC, however, if the Microsoft assembler 
is used. 

As you type the source program, be careful to include only the instruc- 
tions and the comments shown in Listing 6.1A. Do not type the resulting 
hex code that is also given at the beginning of each line. For example, the 
line that defines the parameter TOP, on the first page of the hsting, should 
be typed as 

TOP EQU 24 » MEMORY TOPf K BYTES 
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rather than as : 



0018 = TOP 



EQU 



24 



fHEMORY TOPf K BYTES 



Type a Control-I or tab to automatically generate the blank spaces between 
symbols. 

Most of the assembly language symbols have five or fewer characters. 
This is acceptable to many assemblers. However, if your assembler only 
allows names to have a maximum of five characters, then several symbols 
will have to be shortened. The TITLE directive, on the first line, is another 
potential problem. The CP/M version is shown. The apostrophes should be 
removed if the Microsoft assembler is utilized. If the TITLE directive is not 
available on your assembler, place a semicolon at the beginning of this first 
line to convert it to a comment. 



VERSION 1: THE INPUT AND OUTPUT ROUTINES 

Refer to Listing 6.1 A. This version will contain only the input and output 
routines. Generate an assembler source file with the system editor. The 
following variables will have to be tailored to your particular system. 



Normally, CSTATO will be the same as CSTAT, and CDATAO will be the 
same as CDATA. But if your console input address is different from your 
console output address, then each can be separately defined. Furthermore, 
the address of CDATA will typically have a value one larger or smaller than 
that of CSTAT. 



TOP 



(top of usable memory, decimal K) 



HOME 

CSTAT 

CDATA 

CSTATO 

CDATAO 

INMSK 

OMSK 

BACKUP 



(where to return when done) 
(console input status address) 
(console input data address) 
(console output status address) 
(console output data address) 
(input-ready mask) 



(output-ready mask) 
(console backspace character) 
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Listinsf 6»1A. The besiinnina of a system monitor* 

TITLE '8080 SHStem monltorf ver 1' 
f 

f <put today's date here) 
f 

0018 = TOP EQU 24 5MEH0RY TOP» K BYTES 

5800 - ORGIN EQU (T0P-2)*1024 fPROQRAM START 



5800 




ORG 

9 


ORGIN 






0000 


= 


9 

HOHE 


EQU 





f ABORT (VER 1-2) 






5 HOME 


EOU 


ORGIN 


r ABORT ADDRESS 


0031 




VERS 


EQU 


'1' 


J VERSION NUMBER 


57A0 




STACK 


EQU 


0R6IN-60H 


0010 


= 


CSTAT 


EQU 


lOH 


^CONSOLE STATUS 


0011 


= 


CDATA 


EQU 


CSTAT+1 


f CONSOLE DATA 


0010 




CSTATO 


EQU 


rCTflT 




0011 


= 


CDATAO 


EQU 


CSTATO+1 


5 OUT DATA 


0001 


= 


INMSK 


EQU 


1 


5 INPUT MASK 


0002 




OMSK 


EQU 


2 


? OUTPUT MASK 


57A0 


= 


> 

PORTN 


EQU 


STACK 


r3 BYTES I/O 


57A3 


- 


IBUFP 


EQU 


D i HUf f\Tv> 


* pti ipcrc' pn T WTPP 
f uur r c.r\ r u 1 1\ i Hfv 


D/hO 




T Vtl IITP 

X JpUr u 




IBUFP+2 


; BUFFER COUNT 


57A6 


= 


I BUFF 


EQU 


IBUFP+3 


» INPUT BUFFER 


0008 


= 


5 

CTRH 


EQU 


8 


f"H BACKSPACE 


KJK/KfY 




1 ritf 




9 




0011 


= 


CTRQ 


EQU 


17 








CTRS 


EQU 


19 




0018 




CTRX 


EQU 


24 


f-X, ABORT 


0008 


= 


BACKUP 


EQU 


CTRH 


f BACKUP CHAR 


00 7F 




DEL 


EQU 


127 


f RUBOUT 


OOIB 


= 


ESC 


EQU 


27 


» ESCAPE 


OOF 7 


= 


APOS 


EQU 


(39-'0' ) 


AND OFFH 


OOOD 




CR 


EQU 


13 


5 CARRIAGE RET 


OOOA 


= 


LF 


EQU 


10 


5LINE FEED 


OODB 




INC 


EQU 


ODBH 


; IN OP CODE 


00II3 




OUTC 


EQU 


0D3H 


fOUT OP CODE 


0OC9 




RETC 


EQU 


0C9H 


rRET OP CODE 






f 

start: 








5800 


C34A58 




JHP 


COLD 


fCOLD START 


5803 


C35358 


RESTRT5 


JMP 


WARM 


fWARM START 






} CONSOLE INPUT 


ROUTINE 




5806 


CD1658 


inputt: 


CALL 


INSTAT 


F CHECK STATUS 


5809 


CA0658 




JZ 


INPUTT 


5 NOT READY *** 


580C 


BBll 


INPUT2: 


IN 


CDATA 


rGET BYTE 


580E 


E67F 




AN I 


DEL 




5810 


FE18 




CPI 


CTRX 


f ABORT? 


5812 


CAOOOO 




JZ 


HOME 


?YES 


5815 


C9 




RET 







? GET CONSOLE-INPUT STATUS 
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5816 


DBIO 


INSTATJ 


IN 


CSTAT 




5818 


E601 




ANI 


INMSK 




581A 


C9 




RET 










r 

i CONSOLE OUTPUT ROUTINE 


581B 


F5 


OUTT! 


PUSH 


PSW 




581C 


CD1658 


0UT2S 


CALL 


INSTAT 


j INPUT? 


581F 


CA3558 




JZ 


0UT4 


;no ttt 


5822 


CD0C58 




CALL 


INPUT2 


fGET INPUT 


5825 


FE13 




CP I 


CTRS 


J FREEZE? 


5827 


C21C58 




JNZ 


0UT2 


rNO 






i FREEZE OUTPUT 


UNTIL " 


'« OR "X 


582A 


CD0658 


OUT3 5 


CALL 


INPUTT 


5 INPUT? 


582II 


FEll 




CPI 


CTRQ 


{RESUME? 


582F 


C22A58 




JNZ 


0UT3 


f NO 


3832 


C31C58 




JMP 


0UT2 




5835 


DBIO 


} 

0UT4J 


IN 


CSTATO 


f CHECK STATUS 


5837 


E602 




ANI 


OMSK 




5839 


CA1C58 




JZ 


0UT2 


f NOT READY *** 


583G 


Fl 




POP 


PSW 




583II 


D311 




OUT 


CDATAO 


fSEND DATA 


583F 


C9 




RET 






5840 


ODOA 


» 

SI6N0N: 


DB 


CRfLF 




5842 


205665 




DB 


' Ver ' 




5847 


3100 




DU 


VERS 




5849 


00 




DB 











f 

f CONTINUATION 


OF COLD 


START 


584A 


31A057 


r 

COLD { 


LXI 


SPf STACK 


584D 


114058 




LXI 


DjSignon J message 


d8d0 


CDE258 




CALL 


SENDM 


fSEND IT 






f 

) WARM- 


START ENTRY 








WARHI 


LXI 


H?WARM 


f RETURN HERE 




r~ cr 




PUSH 


H 






Iw JU' £> O -kJ O 




CALL 


CRLF 


?NEW LINE 


585A 


i** Ifa /~> 

CD7758 




CALL 


INPLN 


; CONSOLE LINE 


585P 


tf^ ff^i if** if* 

CDCL58 




CALL 


GETCH 


?GET CHAR 




r c.*i4 




CPI 


'D' 


?DUMP 


5862 


CA5358 




JZ 


WARM 


> ( VER 1 ) 










DUMP 


J HEX/ASCII (2) 


5865 


FE43 




CPI 


'C 


(CALL 


5867 


CA5358 




JZ 


WARM 


> (MER 1-2) 








JZ 


CALLS 


J SUBROUTINE (3) 


586A 


FE47 




CPI 


'G' 


>G0 


586C 


CA5358 




JZ 


WARM 


f(VER 1-2) 






i 


JZ 


60 


; SOMEWHERE (3) 


586F 


FE4C 




CPI 


'L' 


f LOAD 


5871 


CA5358 




JZ 


WARM 


5 (VER 1-3) 






s 


JZ 


LOAD 


fINTO MEMORY (4) 


5874 


C35358 




JMP 


WARM 


ITRY AGAIN 
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f INPUT A LINE FROM CONSOLE AND PUT IT 

i INTO THE BUFFER. CARRIAGE RETURN ENDS 

} THE LINE. RUBOUT OR "H CORRECTS LAST 

f LAST ENTRY. CONTROL-X RESTARTS LINE. 

f OTHER CONTROL CHARACTERS ARE IGNORED 
5 



5877 


3E3E 


INPLN J 


MVI 


A f ' > ' 


? PROMPT 


is:o7Q 


rni RSH 




CALL 


OUTT 




\J O / Lr 




INPL2. 


LXI 


Hf I BUFF 


9 BUFFER ADDR 




^ nwhf 1^ 




SHLD 


IBUFP 


fSAVE POINTER 








MVI 


C J 


« COUNT 






INPLI J 


CALL 


INPUTT 


$ CONSOLE CHAR 


vJ / 


FE20 




CPI 




f CONTROL? 


5889 


DAA8S8 




JC 


INPLC 


J YES 


588C 


FE7F 




CPI 


DEL 


f DELETE 


SBBE 


CAC058 




JZ 


INPLB 


5 YES 


5891 


FE5B 




CPI 


'Z'-f 1 


; UPPER CASE? 








JC 


INPL3 


; YES 


5896 


E65F 




ANI 


5FH 


»MAKE UPPER 




/ / 


INPL3J 


MOV 


MjA 


pInto buffer 


5899 


3E20 




MVI 


Aj32 


1 BUFFER SIZE 


589B 


B9 




CMP 


C 


IFULL? 


589C 


CA8458 




JZ 


INPLI 


5YES» LOOP 


589F 


7E 




MOV 


ArM 


f BET CHAR 








INX 


H 


; INCR POINTER 


S8A1 


oc 




INR 


C 


5 AND COUNT 


58A2 


CD1B58 


INPLEJ 


CALL 


OUTT 


f SHOW CHAR 


58A5 


C38458 




JMP 


INPLI 


5 NEXT CHAR 






1 PROCESS CONTROL CHARACTER 


Doflo 


f" f\ 


INPLC: 


CPI 


CTRH 


?"H? 


58AA 


CAC058 




JZ 


INPLB 




58AD 


FEOD 




CPI 


CR 


» RETURN? 


58AF 


C28458 




JNZ 


INPLI 


;NOr IGNORE 






% 

% END 


OF INPUT 


LINE 




58B2 


79 


» 


MOV 


A>C 


» COUNT 




~r A "7 




STA 


IBUFC 


SSAVE 






( CARRIAGE-RETURN » LINE- 


FEED ROUTINE 


58B6 


3E0D 


r 

CRLFJ 


MVl 


AfCR 




58B8 


CD1B58 




CALL 


OUTT 


fSEND CR 


58BB 


3E0A 




MVI 


AjLF 




58BD 


C31B58 




JMP 


OUTT 


fSEND LF 






t DELETE PRIOR 


CHARACTER 


; IF ANY 


58C0 


79 


INPLBJ 


MOV 


AsC 


5 CHAR COUNT 


58C1 


B7 




ORA 


A 


IZERO? 


58C2 


CA8458 




JZ 


INPLI 


?YES 


58C5 


2B 




DCX 


H 


J BACK POINTER 


58C6 


OD 




DCR 


C 


5 AND COUNT 


58C7 


3E08 




MVI 


A f BACKUP 


■ » CHARACTER 


58C9 


C3A258 




JMP 


INPLE 


^SEND 



f GET A CHARACTER FROM CONSOLE BUFFER 
5 SET CARRY IF EMPTY 
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58CC 


E5 


GETCHI 


PUSH 


H 


5 SAVE REGS 


58CII 


2AA357 




LHLD 


IBUFP 


»GET POINTER 


58D0 


3AA557 




LDA 


IBUFC 


rAND COUNT 


9803 


D601 




SUI 


1 


5DECR WITH CARRY 


58D5 


DAE0S8 




JC 


6ETC4 


JNO MORE CHAR 


58D8 


32A557 




STA 


IBUFC 


ISAVE NEW COUNT 


S8DB 


7E 




MOV 


AfM 


J GET CHARACTER 


58DC 


23 




INX 


H 


rINCR POINTER 


58DD 


22A357 




SHLD 


IBUFP 


?AND SAVE 


58E0 


El 


6ETC4? 


POP 


H 


r RESTORE REGS 


58E1 


C9 




RET 










r 

i SEND 


ASCII 


MESSAGE UNTIL BINARY ZERO 






1 IS FOUND. POINTER IS 


DjE 


58E2 


lA 


SENDH J 


LDAX 





>6ET BYTE 


58E3 


B7 




ORA 


A 


5 ZERO? 


58E4 


C8 




RZ 




»YES» DONE 


58E5 


CrilB58 




CALL 


OUTT 


JSEND IT 


58E8 


13 




INX 


D 


fPOINTER 


58E9 


C3E258 




JMP 


SENDM 


>NEXT 


58EC 






END 







If you don't know the addresses of the console status and data registers 
and you are using the CP/M operating system, there is another approach you 
can take. You can use the I/O routines in the CP/M BIOS. The disadvantage 
of this approach is that CP/M must always be in place whenever the monitor 
is used. The BIOS entry address is given at memory address 1. The console 
status, input and output addresses are obtained by adding, respectively, 3, 6, 
and 9 to this address. The following I/O routines in Listing 6. IB can be sub- 
stituted for the subroutines in Listing 6.1 A starting with the label INPUTT 
and ending with the label 0UT2. If this version is utilized, the addresses in 
the following sections will not agree with your assembly listings. 

Listins 6. IB. Alternate I/O routines usina CP/M BIOS. 



9 CONSOLE INPUT ROUTINE USING CP/M BIOS 
r 

inputt: 



5806 


E5 


INPUT2J 


PUSH 


H 


fSAVE REGISTERS 


5807 


D5 




PUSH 


D 




5808 


C5 




PUSH 


B 




5809 


211558 




LXI 


Hj 1N5 


» RETURN ADDRESS 


580C 


E5 




PUSH 


H 


5 PUT ON STACK 


580D 


2A0100 




LHLD 


1 


5 BIOS WARM START 


5810 


110600 




LXI 


Ds>6 


50FFSET TO INPUT 


5813 


19 




DAD 


D 


rADD IN 


5814 


E9 




PCHL 




5CALL BIOS 


5815 


CI 


IN5.* 


POP 


B 


r RESTORE REGISTERS 


5816 


Dl 




POP 


D 




5817 


El 




POP 


H 




5818 


FE18 




CPI 


CTRX 


5 ABORT? 


S81A 


CA0058 




JZ 


START 


JYES 


58 ID 


C9 




RET 
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i GET CONSOLE- INPUT STATUS USING CP/M 



581E 


E5 


INSTATJ 


PUSH 


H 


5SAVE REGISTERS 


581F 


D5 




PUSH 


D 




5820 


C5 




PUSH 


B 




tJOii. JS. 






LXI 


Hf ST5 


f RETURN ADDRESS 


5824 


E5 




PUSH 


H 


?PUT ON STACK 








LHLD 


1 


pBIOS ENTRY 


5828 


110300 




LXI 


D;3 


fOFFSET TO STATUS 


582B 


19 




DAD 


D 


J ADD TO ADDR 


582C 


E9 




PCHL 




JCALL BIOS 


582n 


CI 


ST5S 


POP 


B 


5 RESTORE REGISTERS 


582E 


Dl 




POP 


D 




582F 


El 




POP 


H 




5830 


B7 




ORA 


A 




5831 


C9 




RET 










i CONSOLE OUTPUT ROUTINE 


, USING CF/n Blub 


5832 


F5 


f 

OUTTt 


PUSH 


PSW 


5 SAVE BYTE 


5833 


CD1ES8 


0UT2S 


CALL 


INSTAT 


» INPUT? 


5836 


CA4e58 




JZ 


0UT4 


5 NO 


5839 


CD0658 




CALL 


INPUT2 


pGet input 


583C 


FE13 




CP I 


CTRS 


» FREEZE? 


583E 






JNZ 


0UT2 


J NO 


5841 


CD0658 


0UT3; 


CALL 


INPUTT 


% input? 


5844 


FEll 




CPI 


CTRQ 


r RESUME? 


5846 


C24158 




JNZ 


0UT3 


f NO 


5849 


C33358 




JMP 


0UT2 




584C 


Fl 


r 

0UT4: 


POP 


PSU 


rOET BYTE 


584D 


E5 




PUSH 


H 


f SAVE REGISTERS 


584E 


D5 




PUSH 


D 




584F 


C5 




PUSH 


B 




5850 


4F 




MOV 


C;A 


pMove byte 


5851 


F5 




PUSH 


PSW 




5852 


215E58 




LXI 


H»0UT5 


? RETURN ADDRESS 


5855 


E5 




PUSH 


H 


5 PUT ON STACK 


5856 


2A0100 




LHLD 


1 


5B10S ENTRY 


5859 


110900 




LXI 


Df 9 


f OFFSET TO OUTPUT 


585C 


19 




DAD 


D 


f ADD TOGETHER 


585D 


E9 




PCHL 




rCALL BIOS 


585E 


Fl 


0UT5: 


POP 


PSW 


fRESTORE REGISTERS 


585F 


CI 




POP 


B 




5860 


Dl 




POP 


D 




5861 


El 




POP 


H 




5862 


C9 




RET 







Some of the constants such as PORTN will not be used at this time. 
However, their inclusion now will simplify things later. There are four 
occurrences of the dummy instruction 



JZ WARM 
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following the label WARM. Each is followed by an instruction that will be 
needed later. These latter instructions are preceded by a semicolon so that 
they will be treated as comments by the assembler. 

There are some other matters that may need to be considered. One has 
to do with the sense of the input and output ready flags. There are three 
conditional jump instructions based on console-ready flags that display a 
logical 1 (active high) when ready. If your flags are inverted, that is, they 
present a logic zero when ready, then the three JZ commands must be 
changed to JNZ commands. These lines, indicated by three stars in the 
listing below, should be changed to 



INPUTTI 


CALL 


INSTAT 


» CHECK STATUS 




JNZ 


INPUTT 


>NOT READY *** 


0UT2S 


» » » 

CALL 


INSTAT 


5 INPUT? 




JNZ 


0UT4 


pHQ *** 


0UT4S 


« » « 

IN 


CSTAT 


fCHECK STATUS 




AMI 


OMSK 






JNZ 


0UT2 


f NOT READY *** 



The routine that corrects keyboard errors is programmed for a video 
console. If you have a console printer instead, change the backspace char- 
acter to a slash. 

BACKUP EQU '/' ^CORRECTION 

This will print a slash when an error is corrected. Otherwise the printer will 
back up during error correction, overstriking the old character with the new. 
You may also need to add some nulls after each carriage return. The prob- 
lem here will be evidenced by missing characters at the beginning of each 
line. The solution is to place additional instructions in the subroutine called 
CRLF. Replace the last statement in this routine with the following. 

CALL OUTT fSEND LINE FEED 
XRA A rGET A ZERO 

CALL OUTT J SEND NULL 
CALL OUTT SAND ANOTHER 
» » « 

• • ♦ (one line for each null) 
JHP OUTT ?LAST NULL 

The rest of the program can be copied directly as it is. The abort com- 
mand is a control-X. Initially, the abort address of HOME will be needed to 
leave the new monitor and return to your regular system. We will change 
this in version 3 when we will add a routine for branching to any memory 
address. 

If you have a TRS-80 Model I, you won't have a control key. There- 
fore, you will have to change several of the commands shown in the listing. 
The original commands follow. 
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CTRH 


(Control- 


H) 


TAB 


(Contpol- 


I ) 


CTRQ 


( Control - 


Q) 


CTRS 


(Control- 


8) 


CTRX 


( Control - 


X) 


DEL 


(DEL/RUB) 




ESC 


(Escspe) 





After you have finished typing the program, exit from the editor and 
assemble the source program with the assembler. The command Mne might be 

B>A}ASH MONl 

or 

B>A:HAC HONl 

for the Digital Research assemblers. These two assemblers will produce two 
files. 

HONl .ASH (sssemblu listing) 

MONl. HEX (hex code) 

In addition, MAC will produce a symbol table 
MONl.SYH (symbol table) 

Inspect the hex code given in the assembly listing to see that it matches 
the corresponding instructions given in this chapter. These 8080 listings have 
all been generated with the Digital Research assembler MAC. This assembler 
displays the hex code for 16-bit operands in the usual reverse order. The 
low-order byte appears first followed by the high-order byte. Thus: 

CDIBSS means CALL 581B and 
C38458 means JHP 5884 

By contrast, the assembly listing produced by the Microsoft assembler 
reverses the usual order of the two bytes. The high-order byte is given first; 
this is followed by the low-order byte. In this case, the listing 

CD 581B means CALL 581B and 
C3 5884 means JMP 5884 

The next step is to load the hex program into memory using the debug- 
ger. The CP/M command wouM be 

B>ASDDT MONl. HEX or 
B>A5SID MONl. HEX 
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Now branch to the beginning of the monitor using the debugger G command. 
G5800 

The first thing that the monitor will do is display the version number on the 
first line and a prompt symbol of > underneath it. 

Try out this first version by typing a series of letters and numbers. Each 
character that is typed should appear (echo) on the console. Try the correc- 
tion keys. Typing either a control-H (backspace) or the RUB/DEL key 
should back up the cursor on a video terminal. Type a carriage return. The 
prompt symbol should appear at the beginning of the next line. If all of the 
features are working properly, type a control-X to return to your regular 
system. If something appears to be wrong, carefully compare your assembly 
listing with the one given in Listing 6.1 A. Don't proceed to the next version 
until the current one is working. 



VERSION 2: A MEMORY DISPLAY 

A provision for examining the contents of memory will now be added. This 
routine is called a memory dump, or dump for short; it displays the contents 
of memory in both hex and ASCII notation. The dump feature is initiated 
with a command of D followed by the address limits in hexadecimal. For 
example, the statement 

>D100 18F 

will dump memory from address 100 to 18F hex. The first address (100 
in this case) must immediately follow the letter D. A space is typed and 
then the second address (18F in this case) is entered. Leading zeros are 
unnecessary. 

Each line will display 16 memory locations. The hexadecimal address 
of the first location will appear at the beginning of the line. Then the hexa- 
decimal representation of the contents will follow, two characters per byte. 
These are arranged in four groups of four bytes. The ASCII representations 
of the data will be given at the end of the line if printable. Otherwise, a 
period is given. A dump of the first line of the monitor might look like this. 

>n5800 580F (your commsnd) 
5800 C35C58C3 A558CD16 58CA0658 DB11E67F .\X.eX. ,X. »X, . . . 

Use your system editor to make the necessary alterations and additions 
to version 1. First, change the version number at the beginning of the 
program. 



VERS EQU '2' EMERSION NUMBER 
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Next, locate the instruction 
JZ BUMP 

that follows the label WARM. Remove the semicolon at the beginning of 
this line. Also delete the line just before it that jumps to WARM. The region 
should now look like this. 

CALL GETCH 

CPI 'D' ?DUMP? 

JZ DUMP 

« * * « * » 

The remaining instructions, shown in Listing 6.2, will be placed at the 
end of version 1, just preceding the END statement. It might be easier to 
delete the END statement, type in the new code, and then add a new END 
statement. The END statement is usually optional, anyway. One of the sub- 
routines (READHL) will translate the dump limits from ASCII-encoded 
hexadecimal into binary. One routine gets both the start and the stop address 
(using READHL) then checks to see that the second address is larger than 
the first. If the second address is smaller than the first, then the task will be 
aborted. Subroutine OUTHEX will convert the binary data already in 
memory into ASCII-coded hex for output to the console. Subroutine TSTOP 
is used to determine when to terminate the dump process. Finally, an error 
routine (ERROR) will be heeded in case an invalid character is entered by 
the user. 

Listing 6.2. Memory display 

f DUMP MEMORY IN HEXADECIMAL AND ASCII 



58EC 


CD2D59 


DUMPS 


CALL 


RDHLDE 


GRANGE 


58EF 


Cn8359 


DUMP2: 


CALL 


CRHL 


»NEW LINE 


58F2 


4E 


DUMP3I 


MOV 


CfM 


(GET BYTE 


58F3 


CD9359 




CALL 


OUTHX 


fPRINT 


58F6 


23 




INX 


H 


? POINTER 


58F7 


7D 




MOV 


AjL 




58F8 


E60F 




AN I 


OFH 


JLINE END? 


58FA 


CA0559 




JZ 


DUMP4 


rYESf ASCII 


58FD 


E603 




ANI 


3 


5 SPACE 


58FF 


CC8E59 




CZ 


OUTSP 


; A BYTES 


5902 


C3F258 




JMP 


DUMP3 


J NEXT HEX 


5905 


CD8E59 


DUMP4: 


CALL 


OUTSP 




5908 


D5 




PUSH 


D 




5909 


IIFOFF 




LXI 


Df~10H 


J RESET LINE 


590C 


19 




DAD 


D 




590D 


Dl 




POP 


D 




590E 


CD1D59 


dumps: 


CALL 


PASCI 


f ASCII DUMP 


5911 


CDA759 




CALL 


TSTOP 


5D0NE? 


5914 


7D 




MOV 


A>L 


;N0 


5915 


E60F 




ANI 


OFH 


5LINE END? 


5917 


C20E59 




JNZ 


DUMPS 


fNO 


591A 


C3EF58 




JMP 


DUMP2 
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} 

i DISPLAY HEMORY BYTE IN ASCII IF 

f POSSIBLE, OTHERWISE GIVE DECIMAL PNT 

f 



591D 


7E 


PASCI 5 


MOM 


A,M 


>GET BYTE 


591E 


FE7F 




CP I 


DEL 


5HIGH BIT ON? 


5920 


D22859 




JNC 


PASC2 


f YES 


5923 


FE20 




CP I 




? CONTROL CHAR 


5925 


D22A59 




JNC 


PASC3 


',m 


5928 


3E2E 


PASC2I 


MVI 


A? ' . ' 


f CHANGE TO DO' 


592A 


C31B58 


PASC3J 


JMP 


OUTT 


rSEND 






9 

i GET H 


?L AND 


DfE FROM CONSOLE 






i CHECK 


THAT 


DfE IS LARGER 


592D 


CD3859 


f 

rdhlde: 


CALL 


HHLDE 




5930 


7B 


RDHLD2} 


MOM 


ArE 




5931 


95 




SUB 


L 


JE - L 


5932 


7A 




MOM 


ArD 




5933 


9C 




SBB 


H 


fD - H 


5934 


DA7B59 




JC 


ERROR 


rHi>L BIGGER 


5937 


C9 




RET 










t 

f INPUT 


HfL AND D?E. SEE 


: THAT 






f 2 ADDRESSES 


ARE ENTERED 


5938 


CD4459 


f 

hhlde: 


CALL 


READHL 


JHfL 


593B 


DA7B59 




JC 


ERROR 


5 ONLY 1 ADDR 


593E 


EB 




XCHG 




f SAME IN D,E 


593F 


CD4459 




CALL 


READHL 


?D»E 


5942 


EB 




XCHG 




rPUT BACK 


5943 


C9 


1 


RET 










f INPUT 


HrL FROM CONSOLE 


5944 


ns 


f 

READHLJ 


PUSH 


D 




5945 


C5 




PUSH 


B 


ISAME REGS 


5946 


210000 




LXI 


HjO 


J CLEAR 


5949 


CDCC58 


RDHL2I 


CALL 


GETCH 


?GET CHAR 


594C 


nA6859 




JC 


RDHL5 


?LINE END 


594F 


CD6B59 




CALL 


NIB 


fTO BINARY 


5952 


DA5E59 




JC 


RDHL4 


?NOT HEX 


5955 


29 




DAD 


H 


f TIMES 2 


5956 


29 




DAD 


H 


fTIMES 4 


5957 


29 




DAD 


H 


f TIMES 8 


5958 


29 




DAD 


H 


f TIMES 16 


5959 


B5 




ORA 


L 


pAdd new char 


595A 


6F 




MOM 


LrA 




595B 


C34959 




JMP 


RDHL2 


fNEXT 






t CHECK 


FOR BLANK AT END 




595E 


FEF7 


7 

RDHL4: 


CPI 


APOS 


J APOSTROPHE 


5960 


CA6859 




JZ 


RDHL5 


SASCII INPUT 


5963 


FEFO 




CPI 


(' '-'0' 


) AND OFFH 


5965 


C27B59 




JNZ 


ERROR 


$N0 


5968 


CI 


RDHL5J 


POP 


B 




5969 


Dl 




POP 


D 


J RESTORE 


596A 


C9 




RET 
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i CONVERT ASCII CHARACTERS TO BINARY 
f 



596B 


D630 


NIBi 


SUI 


'0' 


pASCII BIAS 












f < 


596E 


FE17 




CPI 


'F'-'O'+l 


5970 


3F 




CMC 




? INVERT 


5971 


D8 




RC 




? ERROR f > F 




r CUM 




CPI 


10 




5974 


3F 




CMC 




; INVERT 








RNC 




f NUMBER 0-9 


5976 


D607 




SUI 


'A'-'9'-l 




r cvri 




CPI 


10 


5SKIP : TO 


597A 


C9 




RET 




9 1 1 eft H r 






f PRINT 


? ON 


IMPROPER 


T M C' 1 IT 


597B 


3E3F 


i 

ERROR} 


MMI 


A? '?' 






rni R^ifi 

U J. 17 (JO 




CALL 


OUTT 




5980 


C30058 




JMP 


START 


pTRY again 






5 START 


NEU 


LINEf GIVE 


ADDRESS 


5983 


CDB658 


crhl: 


CALL 


CRLF 


>NEU LINE 






; PRINT 


Hf L 


IN HEX 




DVoo 




i 

outhl: 


MOM 


C?H 




5987 


CD9359 




CALL 


OUTHX 




598A 


4D 


outll; 


Moy 


CfL 








f output hex 


BYTE FROM 


C AND A SPACE 


598B 


CD9359 


OUTHEXS 


CALL 


OUTHX 








i OUTPUT A SPACE 




598E 


3E20 


9 

outsp: 


MVI 


A?' ' 




5990 


C31BS8 




JMP 


OUTT 








f 

i OUTPUT A HEX BYTE FROM C 






f BINARY TO 


ASCII HEX 


CONVERSION 


5993 


79 


y 

OUTHX: 


MOV 


Ai'C 




5994 


IF 




RAR 




fROTATE 


5995 


IF 




RAR 




» FOUR 


5996 


IF 




RAR 




f BITS TO 


5997 


IF 




RAR 




i RIGHT 


5998 


CD9C59 




CALL 


HEXI 


f UPPER CHAR 


599B 


79 




MOV 


ApC 


> LOWER CHAR 


599C 


EAOF 


HEXi: 


AN I 


OFH 


fTAKE 4 BITS 


599E 


C690 




ADI 


90H 




59A0 


27 




DAA 




pDAA TRICK 


59A1 


CE40 




AC I 


40H 




59A3 


27 




DAA 






59A4 


C31B58 




JMP 


OUTT 





5 CHECK FOR END» HtL MINUS DrE 
} INCREMENT Hf L 
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59A7 


23 


TSTOPJ INX 


H 




59A8 


7B 


HOV 


AfE 




59A9 


95 


SUB 


L 


t E - L 


59AA 


7A 


HOV 


A;D 




59AB 


9C 


SBB 


H 


» D - H 


59AC 


DO 


RNC 




5 NOT DONE 


59AD 


El 


POP 


H 


(RAISE STACK 


59AE 


C9 


RET 

5 






59B1 




END 







Type up the new instructions, then, after you leave the editor, rename 
the new file. The CP/M command will be 

REN HON2.ASH=MON1.ASM 
Rename the backup file to its original name. 
REN M0N1.ASM=M0N1.BAK 

Assemble version 2 and load it into memory. Start it up by branching 
to the address of START. Again, the version number should be printed, and 
the prompt symbol should appear. Test the new feature by dumping a por- 
tion of the monitor. 

>D5800 585F 

Be sure to type a carriage return at the end of the line. Input errors can be 
corrected by typing a backspace or DEL. Check to see that the hex code 
displayed on the screen matches the assembly listing code. Most of the 
ASCII representation will be meaningless. But the section from 5842 to 
585A hex will read 

Mer 2 

Now test the scroll-freeze commands. Dump a large section of memory. 
>D0 1000 

Type a control-S as the data are being displayed on the console. The console 
screen should freeze. Now type a control-Q. The screen should again resume 
displaying the data. The commands of Control-S and control-Q will alter- 
nately freeze and resume the scrolling. 

Try the routine that checks for proper dump limits by typing a larger 
address first, then a smaller address. 

D300 200 
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As a result of this improper input, a question mark should be printed. Then 
the prompt will appear on a new line. If everything is all right, return to your 
regular system by entering a control-X. 

If version 2 does not perform satisfactorily, compare the hex code in 
your assembly listing with the values given in Listing 6.2 for the new code. 
Correct any errors, reassemble the program, and try it again. 



VERSION 3: A CALL AND GO ROUTINE 



Now that both hex-to-binary and binary-to-hex routines are available, we can 
easily include new features. A CALL routine and a GO routine will be added 
in version 3. These routines will allow you to branch to any address in mem- 
ory. The GO command will be useful for testing subroutines. For this latter 
command, the monitor warm-start address (WARM) is on the stack when the 
call is made. A subroutine can be called with the C command. The execution 
of an RET instruction at the end of the subroutine will cause a return to 
the monitor. 

First, change the version number to 3. Then find the instructions corre- 
sponding to the C and G commands after the label WARM. Remove the 
semicolons from the beginning of the lines that branch to CALLS and GO. 
Delete the prior lines that jump to WARM. The program should now look like 



CPI 'C fCALL? 

JZ CALLS 

CPI 'G' »G0? 

JZ 60 



The remaining lines of code (and some comments) are placed at the end of 
the source program just prior to the END statement. They are given in 
Listing 6.3. 



Listing 6.3. A CALL and a GO routine . 



t ROUTINE TO GO ANYWHERE IN MEMORY 

; ADDRESS OF WARM IS ON STACK j SO A 

} SIMPLE RET WILL RETURN TO THIS MONITOR 



59AF El 
59B0 CD4459 
59B3 E9 



go; 

CALLS? 



POP 

CALL 
PCHL 



H 

READHL 



jRAISE STACK 
fOET ADDRESS 
f GO THERE 



59B4 



END 



Another importarrt change should be made at this time. Since we can 
now branch to any place in memory with the GO command, we can change 
the abort command, control-X. Redefine HOME near the beginning of the 
source program so that an abort command of control-X will restart the 
monitor. 
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HOME EQU ORGIN fABORT ADDRESS 

This line was originally entered as a comment. Remove the semicolon at the 
beginning of the line and delete the previous Une. 

Assemble the new version and load it into memory. Branch to the 
monitor and try the dump routine as before. Try the CALL feature by 
calling the monitor itself. 

>C5800 

The cold-start message should appear. Now use the GO routine to return to 
your main system. If the GO address is zero, then no argument need follow 
the G command. 

>0 



VERSION 4: A MEMORY-LOAD ROUTINE 



In version 2 we added a routine that could be used to inspect any memory 
location. A routine which can be used to change memory will now be added. 
Change the version number to 4. Locate the instruction 



f JZ LOAD 

following WARM. Remove the semicolon at the beginning of the line. Delete 
the original JZ WARM on the prior line. The program should now look like 

CPI 'L' 
JZ LOAD 



Add the load routines shown in Listing 6.4 to the end of the source program. 



Listina 6.4. A memor«-lo3d routine. 

} LOAD HEX OR ASCII CHAR INTO MEMORY 

f FROM CONSOLE. CHECK TO SEE IF 

( THE DATA ACTUALLY GOT THERE 

> APOSTROPHE PRECEEIiS ASCII CHAR 

f CARRIAGE RETURN PASSES OVER LOCATION 

> 



59B4 


Cn4459 


load; 


CALL 


READHL 


» ADDRESS 


59B7 


CD0659 


L0AD2; 


CALL 


OUTHL 


5 PRINT IT 


59BA 


CniD59 




CALL 


PASCI 


f ASCII 


59BD 


CD8E59 




CALL 


OUTSP 




59C0 


4E 




MOV 


CfM 


jORIG BYTE 


59C1 


CD8B59 




CALL 


OUTHEX 


?HEX 


59C4 


E5 




PUSH 


H 


»SAVE PNTR 


59C5 


CD7C58 




CALL 


INPL2 


f INPUT 


59C8 


CD4459 




CALL 


READHL 


i BYTE 


59CB 


45 




MOV 


hfL 


? TO E 
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59CC 


El 




POP 


H 




59CD 


FEF7 




CPI 


APOS 




59CF 


CADE59 




JZ 


L0AD6 


fASCII INPUT 


59D2 


79 




nuv 




9 nuw riMri i i 


59D3 


B7 




OKH 


A 
M 


a Kin wc? 


59D4 


CADA59 




JZ 


L0An3 


fYES 


59D7 


CDE559 


L0AD4J 


CALL 


CHEKM 


UNTO hEMORY 


59DA 


23 


loads: 


INX 


H 


f POINTER 


59DB 


C3B759 




JMP 


L0AD2 








f 

r LOAD 


ASCII 


CHARACTER 




59DE 


CDCC58 


i 

L0AD6: 


CALL 


DETCH 




59E1 


47 




HOV 


BrA 




59E2 


C3D759 




JMP 


L0AD4 








$ 

£ pnPY 

f l*Ur 1 


BYTE 


FROM B TO 


MPMDRY 






$ AND 


SEE THAT IT GOT 


THERE 


59E5 


70 


7 

CHEKM5 


MOV 


M>B 


fPUT IN MEM 


59E6 


7E 




Moy 


A;M 


f GET BACK 


59E7 


B8 




CMP 


B 


f SAME? 


59E8 


C8 




RZ 




fYES 


59E9 


C37B59 




JMP 


ERROR 


;bad 


59EC 




5 


END 







Assemble version 4 and compare the assembly listing of the new part to 
Listing 6.4. Load the new program and branch to the beginning. Recheckthe 
dump command by examining the new code for the load routine 

>D59B4 59EB 

Now try the load command. Great care must be taken when typing the load 
address. This command will actually change the contents of memory, includ- 
ing the monitor itself. 

Type the letter L, the hexadecimal address, and a carriage return. The 
response will be the address that was typed and the current contents of that 
memory location. The data are represented two ways: in ASCII and in hex. 
If the ASCII value is not a printable character, it is rendered as a period. 

The displayed location can now be changed by typing the new value 
and a carriage return. The data can be entered in several ways. It can be in 
the form of one or two hex characters. If more than two characters are 
entered, only the last two are actually used. This allows you to correct an 
error by continuing to type. Errors can also be corrected with the backspace 
or the DEL/RUB key. A single ASCII character can be entered into memory 
by preceding it with an apostrophe. 

As each new value and a carriage return is typed, the next address and 
the present data value will appear. In this way, a machine-language routine 
can be entered from the console. Of course, using an assembler is a more 
efficient way to generate a long program. But our load routine will be useful 
for making simple changes or for writing short routines. 
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The load command is terminated by typing a control-X (if you redefined 
HOME as ORGIN back in version 3). It is also terminated if you enter a 
nonhex character. Control then returns to the monitor. If the load command 
is used to revise existing code, another feature is useful. A carriage return is 
given without entering any data. The memory pointer then skips over the 
current location and the corresponding value is not changed. 

After each revised byte is entered into memory, the monitor checks to 
see that the new value is correct. If an attempt is made to write into pro- 
tected, nonexistent, or defective memory, the load process is terminated and 
a question mark is printed. 

Try the load routine by entering the following five bytes into a conve- 
nient location such as 4000 hex. 

3E 7 D3 XX C9 

This sequence corresponds to the assembly language program 

3E07 mi At7 
D3XX OUT XX 
C9 RET 

The value of XX is the console-data address (CDATA in the source program). 
Check the code with the dump command. 

D4000 4004 

Now use the CALL command to execute the routine 
C4000 

The console bell should sound and control will return to the command level 
of our monitor. 



VERSION 5: USEFUL ENTRY POINTS 

Changes to the first four versions were made for the most pa^t by adding 
new instructions to the end of the existing program. For versions 5, 6, and 7, 
we are going to start the process over to some extent by inserting some new 
instructions in the middle of the existing program. 

At the beginning of the monitor there are two jump instructions. 

JMP COLD 
JMP WARH 

Entry points such as these are sometimes called vectors. The first jump to 
COLD is the initial, cold-start entry point into the monitor. Stack initiali- 
zation and printing of the sign-on message occur at this time. But other 
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housekeeping chores, such as interface initialization, could be performed in 
this section. The second vector causes a jump to WARM, a restart entry point 
that does not alter the stack pointer. 

We will now insert some additional vectors after these first two. The 
additional jumps will provide fixed entry points to useful subroutines in the 
monitor. These routines can then be easily called by other programs outside 
the monitor. Since these jump instructions are all at the beginning of the 
monitor, their addresses won't change when the monitor is altered. Further- 
more, new vectors can be added to the end of the group without affecting 
those already present. 

Place the five jump instructions shown in Listing 6.5 at the beginning of 
the monitor just after the first two (START and RESTRT). 



Listing 6.5» Some useful entry F-oints . 

) VECTORS TO USEFUL ROUTINES 
f 



5806 


C32A58 


COUTJ 


JHP 


OUTT 


> OUTPUT CHAR 


5809 




CINJ 


JMP 


INPUTT 


r INPUT CHAR 


580C 


C3D058 


inln; 


JMP 


INPLN 


r INPUT LINE 


580F 


C32559 


GCHARt 


JMP 


GETCH 


J GET CHAR 


5812 


C3EC59 


OUTHJ 


JHP 


OUTHX 


fBIN TO HEX 



t 



Reassemble the monitor, load it into memory, and try the DUMP, LOAD, 
and GO routines again to be sure that they still work. Now, when separate, 
external routines are written, they need not contain subroutines for console 
input, output, conversion of binary to hex, and so on. 

A character can be displayed on the console by calling COUT with the 
character in the accumulator. A single console character is obtained by 
calling GIN. The byte is returned in the accumulator. 

An entire line of characters can be easily obtained by calling the line- 
input entry INLN. As each character is typed, it is automatically printed on 
the console. The error-correction commands are available at this time. The 
backspace and DEL/RUB keys can be used to delete the previously typed 
character. A line is normally terminated with a carriage return. After the 
console-input buffer has been filled by a call to INLN, the GGHAR address 
can be called. 

A character is returned in the accumulator for each call to GCHAR. 
When the input buffer has been exhausted, the carry flag is set. Typing a 
control-X will abort a routine and return control to the monitor. Therefore, 
it is not necessary to include an abort routine in separate, external programs. 

The fifth new entry point will perform a conversion from binary to 
ASCII-coded hexadecimal. This will allow display of individual memory 
locations or any of the GPU registers. The byte to be converted is placed in 
the C register and the address of OUTH is called. The accumulator is also 
used by the conversion routine in this case, so it may be necessary to save 
the accumulator's original contents on the stack by using a PUSH instruction. 
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Use the monitor to write the following short routine. This program will 
demontrate the new vectors. 

3E07 MVI A, 7 

€30653 JMP COUT 

This program, which is similar to the one written in the last section, can be 
placed almost anywhere in memory. This time, however, there is no need to 
worry about the output device address since the monitor takes care of this. 
Branch to the routine by giving the monitor command of C and the address 

>C4000 

The monitor output routine will ring the console bell, then cause a return to 
the address WARM. 

The monitor now contains a bare minimum of features. The DUMP, 
LOAD, GO, and CALL routines can be used to write and inspect simple 
routines. The several vectors located at the beginning of the monitor, allow 
easy access to useful subroutines within. These vectors will greatly simplify 
the task of writing and debugging simple routines. 

At this point, you may wish to go on to Chapter 8 and try some of the 
routines discussed there. Otherwise, continue in this chapter as we add more 
features to the monitor. The new features will include memory fill and zero, 
memory search, ASCII load and dump, input from and output through any 
port, a memory test, byte replacement, and memory comparison. 



VERSION 6: AUTOMATIC MEMORY SIZE 

A routine that will automatically find the top of usable memory will be 
added for version 6. The routine is executed each time a cold or warm start 
is performed. The first byte of memory in each page of 256 bytes of mem- 
ory is checked, starting with page zero. The byte in memory is moved to the 
accumulator, complemented, then written back to the same memory loca- 
tion. The result is compared to the accumulator to see if it is the same. If so, 
then the byte in the accumulator is complemented back to the original byte 
and it is written back into memory. This effectively restores the original byte. 

Each page of memory is checked in this way until the monitor stack 
area is encountered or until defective, missing, or protected memory is 
found. The hexadecimal value of this top page is printed just preceding the 
monitor greater-than prompt (>). For example, if the monitor starts at 
5800 hex and the stack is located at 57A0, then the prompt will appear as 

57> 
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This routine provides a regular, continuous check on the memory size. It 
does not check all of the memory, but only the first byte of each 256 bytes 
of the page. Nevertheless, this check may point up potential problems. A 
more complete memory test program will be added in version 15. 



Listing 6.6. Automatic memory check. 

i FIND TOP OF USABLE MEMORY. 

; CHECK FIRST BYTE OF EACH PAGE OF MEMORY 

i STARTING AT ADDRESS ZERO. STOP AT STACK 

i OR MISSING/DEFECTIME/PROTECTED MEMORY. 

5 DISPLAY HIGH BYTE OF MEMORY TOP. 



5865 


210000 




LXI 


Hf 


fPAGE ZERO 


S868 


0657 




MVI 


Br STACK 


SHR 8 


S86A 


7E 


npage: 


MOM 


A>M 


IGET BYTE 


S86B 


2F 




CMA 




; COMPLEMENT 


586C 


77 




MOV 


MrA 


f PUT IT BACK 


586D 


BE 




CMP 


M 


f SAME? 


586E 


C27858 




JNZ 


MSIZE 


;m, MEM TOP 


5871 


2F 




CMA 




;0RI6 BYTE 


5872 


77 




MOM 


Mf A 


f RESTORE IT 


5873 


24 




INR 


H 


f NEXT PAGE 


5874 


05 




DCR 


B 




5875 


C26A58 




JNZ 


NPAGE 


»KEEP GOING 


5878 


4C 


MSIZE! 


MOM 


CfH 


JMEM TOP 


5879 


CD0F59 




CALL 


CRLF 


f NEW LINE 


587C 


CDEC59 




CALL 


OUTHX 


» PRINT MEM SIZE 


587F 


CDD058 




CALL 


INPLN 


J CONSOLE LINE 


5882 


CD2559 




CALL 


GETCH 


f FIRST CHAR 



Insert the new instructions shown in Listing 6.6 right after the PUSH H 
instruction that follows the label WARM. 

warm: LXI HrWARH J RET TO 

PUSH H f HERE 

(add new code here) 

If your assembler does not have the shift-right operation SHR, then just code 
the high half of the stack address. The second line in Listing 6.6 might look 
like this instead. 

HMI B>57H 

Assemble the new version. Check the assembly listing to see that the new 
additions are correct. Then try out version 6. 
The symbol table at this point follows. 
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symbols* 



00F7 


APOS 


0008 


BACKUP 


59B0 




001 1 

X X 


L*X»ri 1 H 


001 1 


CDATAfl 


*J 7 *J 








A A A ri 


LK 


5983 


CRHL 








r*e TAT 


Oulo 


« « -f- A X O 

LS 1 ATU 


0008 


CTRH 


001 1 


<-r 1 f\\A 




tr 1 Kb 


OOlo 


CTRX 


wV / r 




DCJC-L 


Til tMCi 

iiUfIr 


58EF 


DUMP2 


58F2 


DUMP3 


5905 


nilMP4 




fl 1 i M P 




C.KKUK 


001 B 


ESC 


58E0 


GETC4 


(JO L/l^ 


13C 1 WD 




fin 


OWL 


HEXl 


5938 


HHI Tip 




nUnc 


«?: "7 ABC 


T 'Bii idcr* 
IssUr U 


57A6 


IBUFF 


57A3 


IBUFP 




J. }yw 


AAA 1 




DO/L. 


INF'L2 


5898 


IMPl ^ 










C (T A -"1 


INF'LE 


5884 


INPLI 


5877 


INPLN 


w O v 






TMPIITT 


5816 


INSTAT 


OOOA 


LF 


59B4 


LOAD 


59B7 


L0AD2 


59DA 


LOADS 


59D7 


L0AD4 


59DE 


L0AD6 


596B 


NIB 


0002 


OMSK 


5800 


ORGIN 


581C 


0UT2 


582A 


0UT3 


5835 


0UT4 


00D3 


OUTC 


598B 


OUTHEX 


5986 


OUTHL 


5993 


OUTHX 


598A 


OUTLL 


598E 


OUTSP 


581B 


OUTT 


5928 


PASC2 


592A 


PASC3 


591D 


PASCI 


57A0 


PORTN 


5949 


RDHL2 


595E 


RDHL4 


5968 


RDHL5 


5930 


RDHLn2 


592D 


RDHLDE 


5944 


READHt 


5803 


RESTRT 


00C9 


RETC 


58E2 


SENDH 


5840 


SIGNON 


57A0 


STACK 


5800 


START 


0009 


TAB 


0018 


TOP 


59A7 


TSTOP 


0031 


VERS 



5853 WARM 



VERSION 7: COMMAND-BRANCH TABLE 

Before incorporating additional features into the monitor, we should make 
a fundamental change in the command processor routine. This routine inter- 
prets the initial character of the command hne. The routine looks for com- 
mands beginning with the letter D, C, G, or L. Five bytes of instruction are 
needed for each one of these commands. For example, the LOAD routine 
uses the instructions 

CPI 'L' 
J2 LOAD 

Since there are 26 letters of the alphabet, there will eventually be 26 times 
5, or 130 bytes needed if 26 different commands are incorporated. This 
approach is satisfactory for a short table, but there is a better approach when 
there are many entries. 

An alternate method is to use a command branch table. This method 
only requires two bytes per table entry plus 23 bytes of decoding instruc- 
tions. The disadvantage of this method is that all 26 table entries will have to 
be allocated, even if only a few are needed. Thus, there may be a lot of 
unallocated table entries. 

Delete the 13 lines of program immediately following the command of 
CALL GETCH, just after the label MSIZE. 
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CPI 'D' fDUMP <del«te 13 lines> <====! 

... I 

JHP * WARM 5 TRY AGAIN <====! 

The new code that will be added is given in Listing 6.7. Notice that there are 
26 table entries. Each line corresponds to one letter of the alphabet. At this 
time, most of the entries refer to the enoi routine called ERROR. This is 
because we have not yet incorporated many features. As new features are 
added to the. monitor, these error references will be replaced by the desired 
subroutine names. 



Listinsi 6.7. 


Com^snd- 


■brench 


table. 










i MAIN 


COMMAND 


PROCESSOR 






58B5 


D641 


f 


SUI 


'A' 


5C0NVERT OFFSET 


5887 


DAD459 




JC 


ERROR 


5 < 


A 


588A 


FEIA 




CPI 


'Z'-'A'+l 




588C 


020459 




JNC 


ERROR 


5 > 


Z 


588F 


87 




ADD 


A 


S DOUBLE 


5890 


219C58 




LXI 


H» TABLE 


1 START 


5893 


1600 




MVI 


DpO 






5895 


5F 




MOV 


Ef A 


f OFFSET 


5896 


19 




DAD 


n 


^ADE 


i TO TABLE 


5897 


5E 




MOM 


Ef M 


SLOW 


1 BYTE 


5898 


23 




INX 


H 






5899 


56 




MOV 


DfM 


>HIGH BYTE 


589A 


£B 




XCHG 




UNTO HrL 


589B 


E9 




PCHL 




;go 


THERE 






) COMMAND TABLE 






589C 


D459 


table: 


DU 


ERROR 


rAr 


ASCII 


589E 


D459 




DW 


ERROR 


>B 






V 7 *Jrl 




DW 


CALLS 


iCt 


CALL SUBR 


58A2 


4559 




DM 


DUMP 


! D f 


DUMP 


S8A4 


D459 




DU 


ERROR 


?E 




58A6 


D459 




DU 


ERROR 


fFf 


FILL 


58A8 


085A 




DU 


GO 


f6f 


GO 


58AA 


D459 




DU 


ERROR 




HEX MATH 


S8AC 


D459 




DU 


ERROR 


n, 


PORT INPUT 


58AE 


D459 




DU 


ERROR 


f jt 


MEMORY TEST 


58B0 


D459 




DU 


ERROR 


$K 




58B2 


0D5A 




DU 


LOAD 


r L f 


LOAD 


58B4 


D459 




DU 


ERROR 


?M? 


MOVE 


S8B6 


D459 




DU 


ERROR 


IH 




58B8 


D459 




DU 


ERROR 


fOf 


PORT OUTPUT 


58BA 


D459 




DU 


ERROR 


f P 




58BC 


D459 




m 


ERROR 


fQ 




58BE 


D459 




DU 


ERROR 


?ftf 


REPLACE 


58C0 


D459 




DU 


ERROR 


fSf 


SEARCH 


58C2 


D459 




DU 


ERROR 


5T 




58C4 


D459 




DU 


ERROR 


fU 




58C6 


D459 




DU 


ERROR 


»Vr 


VERIFY MEM 


58C8 


D459 




DU 


ERROR 


fU 




58CA 


D459 




DU 


ERROR 


fXf 


STACK POINTER 


58CC 


D459 




DU 


ERROR 


pY 




58CE 


D459 




DU 


ERROR 


fZ> 


ZERO 
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Generate the new version, assemble it, and compare the resulting assem- 
bly listing to the one given in Listing 6.7. Try out version 7. It should behave 
exactly like version 6. It will be a bit longer than version 6 at this stage, but 
it will not grow as rapidly as we add new features. In the remainder of this 
chapter, we will add the new subroutines to the end of source program. The 
label for the subroutine will be placed in the appropriate place of the com- 
mand branch table. 



VERSION 8: DISPLAY THE STACK POINTER 

By adding seven bytes of new code, we will be able to examine our monitor's 
stack pointer. This will alert us to a possible problem with the monitor 
itself. We may find, for example, that as we use the monitor, the stack tends 
to grow up or down in memory, rather than remain in the same place. This 
is undesirable and indicates that we are not properly lowering or raising the 
stack somewhere in the program. For example, subroutine TSTOP increments 
the pointer then checks to see if the current task should be terminated. If so, 
the stack is raised with a POP instruction. Then a return instruction skips 
one level of subroutines, so that control returns to the address of WARM. 

Change the version number to 8. Also change the entry in the command 
table that corresponds to the command of X. This is the third from the last 
entry. Delete the word ERROR and replace it with the word REGS. 

DW REGS JXr STK POINTER 

Then go to the end of the source program. We will make a minor change in 
subroutine CHECKM, the last subroutine in the monitor. Then the new 
instructions will be added. Delete the END statement and the instruction 
just prior to the END statement. 

JMP ERROR 5 BAD 

Then add the new instructions as shown in Listing 6.8. 



Listinsi 6.8. 


Display 


the stack 


pointer 


« 


5A42 


Fl 


errp: 


POP 


PSW 


5RAISE STACK 


5A43 


3E42 


ERRBJ 


mi 


Ar 'B' 


rBAD 


5A45 


CD2A58 


ERR2: 


CALL 


DUTT 




5A48 


CDE759 




CALL 


OUTSP 




5A4B 


C3DF59 




JMP 


OUTHL 


fPOINTER 






i DISPLAY STACK 


POINTER 


REGISTER 


5A4E 


210000 


REGS: 


LXI 


H>0 




5A51 


39 




DAD 


SP 




SA52 


C3DF59 




JMP 


OUTHL 
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Reassemble the monitor and try it out. First give the X command (with no 
argument). Make a note of the value given for the stack pointer. Now, try 
other monitor features such as the dump and load commands. After each of 
these commands, give the X command to see that the stack pointer remains 
in the same place. 

Try the separate routine that rings the console bell. This routine, which 
was written for version 4, may have to be rewritten if it was destroyed by 
the assembler or the editor. Again, check that the stack pointer is still in the 
same place. When you are convinced that everything is all right, continue to 
the next version. 



VERSION 9: ZERO AND FILL ROUTINES 

In version 4, we added a routine that could be used to change individual 
memory locations, one at a time. We will now add a routine which will allow 
us to fill a portion of memory with a constant value. A separate command 
for zeroing memory is also added for convenience, even though this opera- 
tion could be performed with the FILL command. 

Change the version number to 9, then alter the two command table 
entries that correspond to the F (fill) and Z (zero) commands. 

DW FILL iFf HEMORY 

* » « 

m ZERO fZf MEMORY 

Add the new code shown in Listing 6.9 to the end of the program. 

Listing 6.9. Zero and fill routines. 

i ZERO A PORTION OF MEMORY 
t THE MONITOR AND STACK ARE 
t PROTECTED 



SA55 


CD8659 


ZEROi 


CALL 


RDHLDE 


p RANGE 


5A58 


0600 




MVI 


BfO 




5A5A 


C3665A 




JMP 


FILL2 








f 

5 FILL 


A PORTION OF MEMORY 


5A5D 


CD7C5A 


f 

fill: 


CALL 


HLDEBC 


?RANOE» BYTE 


5A60 


FEF7 




CPI 


APOS 


f APOSTROPHE? 


5A62 


CA755A 




JZ 


FILL4 


fYES ASCII 


5A&5 


41 




MOV 


BfC 




5A66 


7C 


FILL2; 


MOV 


ArH 


5FILL BYTE 


5A67 


FE57 




CPI 


STACK 


SHR 8 jTOO FAR? 


5A69 


020459 




JNC 


ERROR 


f YES 


5A6C 


CD3E5A 


FILL3; 


CALL 


CHEKM 


fPUTr CHECK 


5A&F 


Cn005A 




CALL 


TSTOP 


pDONE? 


5A72 


C3665A 




JMP 


FILL2 


fNEXT 



i 
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5A75 CD2559 
5A78 47 
5A79 C36C5A 



FILL4{ 



CALL 
JHP 



GETCH 

B>A 

FILL3 



> ASCI I CHAR 



i GET HrL DfE AND BrC 



5A7C C08ASA 
5A7F DAD459 

SA82 E5 
5A83 CD9D59 
5A86 44 
5A87 4D 
5A88 El 
5A89 C9 



HLDEBC: CALL 
JC 

PUSH 

CALL 

HOV 

MOV 

POP 

RET 



HLDECK 

ERROR 

H 

READHL 
BrH 
CfL 
H 



GRANGE 
5 NO BYTE 

(3RD INPUT 
fMOVE TO 
i BrC 



GET 2 ADDRESSES > CHECK THAT 
ADDITIONAL DATA IS INCLUDED 



SA8A CD9159 

5A8D DAD459 
5A90 C38959 



HLDECK J CALL 

JC 
JMP 



HHLDE 
ERROR 
RDHLD2 



}2 ADDR 

? THAT'S ALL 

5 CHECK 



Assemble the program, load it into memory, and try it out. First, dis- 
play a portion of memory. 

>D4000 404F 

Then, zero out a part of this region. 

>24000 403F 

Display the region again to be sure that the zero routine is working. Now fill 
a portion of the previously zeroed memory with A5 hex bytes. 

>F4001 401E A5 

Again, dump this region of memory to ensure that the fill routine is working. 

>D4000 404F 

Finally, check the ASCII fill command by filling with a $ symbol. 
>F4020 402F '« 

As with the load command, ASCII input is preceded by an apostrophe. 



VERSION 10: A BLOCK-MOVE ROUTINE 

The next routine to be added will allow us to move a block data from one 
memory location to another. This is actually a duplication routine, since the 
original memory block will remain unchanged. As each byte is moved to the 
new location, a check is made to ensure that it actually got there. 
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First, change the version number to 10. Then add the new lines to the 
end of the source program. Change the branch table entry corresponding to 
the command of M. 

DU HOME iHf MEMORY 

Insert the instructions given in Listing 6.10 to the end of the source program. 
Assemble the monitor and try it out. 



Listing 6«10. A block-wove routine. 







f MOVE 


A BLOCK 


OF MEMORY 


H,L-DfE TO B 


5A93 


Cn7CSA 


9 

MOVE J 


CALL 


HLDEBC 


>3 ADDR 


5A96 


CDA05A 


MOVDN? 


CALL 


MOVIN 


f MOVE/CHECK 


5A99 


CD005A 




CALL 


TSTOP 


>DONE? 


5A9C 


03 




INX 


B 


fNO 


5A9D 


C3965A 




JMP 


MOVDN 




5AA0 


7E 


p 

MOMINJ 


MOM 


A ? M 


f BYTE 


5AA1 


02 




STAX 


B 


jNEW LOCATION 


5AA2 


OA 




LDAX 


B 


f CHECK 


5AA3 


BE 




CMP 


M 


J IS IT THERE? 


SAA4 


C8 




RZ 




fYES 


5AA5 


60 




MOV 


HfB 


1 ERROR 


5AA6 


69 




MOV 


LfC 


sINTO HfL 


5AA7 


C342SA 




JMP 


ERRP 


>SHOU BAD 



The move command requires three addresses. These are the start and 
stop address of the source block and the start address of the destination 
block. For example, 

>M5800 58FF 4000 

will move the first page of the monitor (5800 to 58FF hex) down to the 
address range 4000 to 40FF hex. 

The move routine is designed to move data downward. Thus the first 
byte of a block can be deleted by moving the remainder of the program 
downward by one byte. The command 

>M103 1000 100 

moves the memory block in the address range 103 through 1000 down three 
bytes to the memory range 100 through FFD hex. On the other hand, a 
block move in the upward direction must be done carefully. 

If the new block does not overlap the old, then there is no problem. 
But if there is an overlap, then the upward move will destroy some of the 
data. One possible solution to this problem is to first move the block down- 
ward until it is clear of the new upper block. Then move the block up to the 
desired location. Another possibility is to move the upper half of the block 
first, then move the lower half. 
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The best solution is to have a more sophisticated move routine. This 
routine should first determine whether the move is to be upward or down- 
ward. If the movement is downward, then the move commences with the 
lower part of the block (as with the present program). But if the move is 
upward, then it should begin with the upper end of the block. The memory 
pointers should now move downward in memory. With this approach, the 
original data will be unaltered. This additional feature is more easily coded 
with the Z-80 block-move routines than with the 8080 instructions. 

We have not incorporated the upward-move feature at this time. In 
developing a system monitor, there must be a tradeoff between features and 
space. A minimum of idiot-proofing is necessary. But, if we want to have a 
monitor that will fit into IK bytes of ROM, we will have to make some 
compromises. 

Notice that this move routine moves a byte from the source location 
into the destination location. It then reads the byte back from the new loca- 
tion to see that it actually got there. If an attempt is made to move data into 
read-only memory, protected memory, or defective memory, the process will 
be terminated. The address of the location will be printed following the 
letter B (for "bad"). 

If we want to retain this memory-checking feature, we will not be able 
to use the Z-80 block-move routines. The problem is that the Z-80 routines 
perform an automatic pointer increment after each byte is moved. If a 
memory check is desired, then the destination pointer will have to be backed 
up after each byte is moved. This will allow the newly moved byte to be 
checked. Finally, the pointer will have to be incremented again. 



VERSION 11: A SEARCH ROUTINE 

Sometimes it is necessary to find a particular data byte or address in memory. 
Or perhaps all occurrences of a data byte or an address within a memory 
block are needed. For version 11, we will add a hex search routine. Change 
the version number and the branch table entry for the letter S. 

DW SEARCH fS> MEMORY 

Add the new instructions as given in Listing 6.11. 

Listinsi 6.11. Search for 1 or 2 bytes. 

f SEARCH FOR 1 OR 2 BYTES OVER THE 

' RANGE H»L D»E. BYTES ARE IN B,C 

i B HAS CARRIAGE RETURN IF ONLY ONE BYTE 

i PUT SPACE BTWEEN BYTES IF TWO 

i format: START STOP BYTEl BYTE2 

f 

5AAA CD7C5A SEARCH: CALL HLDEBC > RANGE > 1ST BYTE 
5AAD 060D SEAR2: MMI BfCR J SET FOR 1 BYTE 
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5AAF 


DAB85A 


JC 


SEAR3 


5 ONLY ONE 


5AB2 


E5 


PUSH 


H 




5AB3 


CD9D59 


CALL 


READHL 


»2ND BYTE 


5AB6 


45 


MOV 


Bs>L 


UNTO C 


5AB7 


El 


POP 


H 




5AB8 


7E 


SEAR3: MOM 


AfM 


J GET BYTE 


5AB9 


B9 


CMP 


C 


» MATCH? 


SABA 


C2CF5A 


JNZ 


SEAR4 


im 


5ABB 


23 


INX 


H 


J YES 


SABE 


78 


MOV 


As>B 


fONLY 1? 


5ABF 


FEOD 


CP I 


CR 




5AC1 


CAC95A 


JZ 


SEARS 


pYES 



f FOUND FIRST MATCH p CHECK FOR SECOND 



5AC4 7E 
5AC5 B8 
5AC& C2CF5A 

5AC9 2B 
5ACA C5 
5ACB CDDC59 
5ACE CI 
5ACF CD005A 
5AD2 C3B85A 



MOV AfM I NEXT BYTE 

CMP B > MATCH? 

JNZ SEAR4 fNO 

i 

sears: dcx h ;a match 

PUSH B 

CALL CRHL fSHOW ADOR 

POP B 

SEAR4J CALL TSTOP JDONE? 

JMP SEAR3 fNO 



Our new feature will display the address of every occurrence of one or 
two chosen bytes. For example, the command 

>S100 4FF OD 

will print the address of each occurrence of a carriage return (OD hex) over 
the memory block 100 to 4FF hex. The alternate command 

>S0 FFFF 3E 10 

includes two search bytes. This command will look for the byte 3E followed 
by the byte 10 over the entire 64K-byte memory range. These two bytes 
might represent the 8080 instruction MVI A,10 or perhaps the address 
103E hex. 

Notice that if two search bytes are given in the command, they must 
be separated by a space. If the command is incorrectly given without the 
space between the bytes, the search will only include the second byte. For 
example, the command 

>S0 FFFF 3E10 

will be interpreted as a search for the byte 10 hex. This occurs because only 
the last two characters of the field are used. 
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VERSION 12: ASCII LOAD, SEARCH, AND DISPLAY 

At this time, the monitor is hex oriented, but it is capable of hmited ASCII 
operations. For example, the DUMP routine gives both the hex and the 
ASCII representation of the data. The load and fill commands will accept 
ASCII characters when preceded by an apostrophe. In version 12, we will 
add three new ASCII commands: ASCII load, ASCII dump, and ASCII 
search. A continuous series of ASCII characters (a string), including a car- 
riage return, line feed, tab, and so on, can be entered directly into memory. 
A straight ASCII dump will render an ASCII portion of memory in its 
natural form. And we will be able to search the memory for one or two 
ASCII characters. If the command line begins with the letter A, a branch 
will occur to a second command processor. The letter following the A will 
cause a jump to the desired task of dump, load, or search. 

Change the version number to 12 and the command table entry for the 
letter A. 

DM ASCII lAf DUHPf LOAD 

Type the code from Listing 6.12; assemble the new version and start it up. 

Listing 6.12» ASCII lo3d!> searchs' 3nd disFlaut 
> ASCII SUB-COMMAND PROCESSOR 



SAOS 


CD2559 


ASCII: 


CALL 


GETCH 


J NEXT CHAR 


5AD8 


FE44 




CPI 


'D' 


JDISPLAY 


SADA 


CA04SB 




JZ 


AOUMP 




5A00 


FE53 




CPI 


'S' 


> SEARCH 


5ADF 


CA2C5B 




JZ 


ASCS 




5AE2 


FE4C 




CPI 


'L' 




5AE4 


C2D459 




JNZ 


ERROR 








p 

r LOAD 


ASCII 


CHARACTERS 


INTO MEMORY 






i QUIT 


ON CONTROL-X 




5AE7 


CD9D59 




CALL 


READHL 


1 ADDRESS 


5AEA 


CDDF59 




CALL 


OUTHL 


5PRINT IT 


5AED 


CD1558 


AL0D2J 


CALL 


INPUTT 


5NEXT CHAR 


5AF0 


CD2A58 




CALL 


OUTT 


» PRINT IT 


5AF3 


47 




MOV 


BrA 


t SAVE 


5AF4 


CD3E5A 




CALL 


CHEKM 


flNTO MEMORY 


5AF7 


23 




INX 


H 


fPOINTER 


5AF8 


7D 




MOV 


A»L 




5AF9 


E67F 




ANI 


7FH 


fLINE END? 


5AFB 


C2ED5A 




JNZ 


AL0D2 


;no 


SAFE 


CDDC59 




CALL 


CRHL 


fNEU LINE 


SBOl 


C3ED5A 




JMP 


AL0D2 





J 

f DISPLAY MEMORY IN STRAIGHT ASCII. 

f KEEP CARRIAGE RETURN » LINE FEED, CHANGE 

f TAB TO SPACE, REMOVE OTHER CONTROL CHAR, 
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5B04 


CD8659 


ADunP ; 


CALL 


c< ri U i ¥^ ET 

KUHLUfc. 


f KHNbt. 


5B07 


7E 


ADnP2 J 


HOV 


A hit 


£ nfCTT tiVTCT 


5B08 


FE7F 




LP 1 


ITsC" 1 

i/c.L 


?rilun PiS uiMf 


5B0A 


D2265B 




JNC 


A Ta M C« j| 




5B0It 


FE20 




CP I 


/ y 


? UUl^! 6 rvUL. f 


5B0F 


7s O O "T KT ri 

D223SB 






HJ-'rir O 




ceo < o 
9B1^ 


r tUU 




PP T 


V/ rv 


STARR RFfP 








17 


ntJt ft %y 


}YF<=i» OK 


5B17 


FEOA 




CPI 


LF 


ILINE FEED? 


5B19 


CA235B 




JZ 


ADMP3 


J YES» OK 


5B1C 


FE09 




CPI 


TAB 




5B1E 


C2265B 




JNZ 


AnMP4 


5 SKIP OTHER 


5B21 


3E20 




HVI 


Af ' ' 


> SPACE FOR TAB 


5B23 


Cri2A58 


ADMP3: 


CALL 


OUTT 


f SEND 


5B26 


CD005A 


ADMP4} 


CALL 


TSTOP 


f DONE? 


5B29 


C3075B 




JMP 


ADMP2 


sNO 



5 SEARCH FOR 1 OR 2 ASCII CHARACTERS 

J NO SPACE BETyEEN ASCII CHARS 

) format: START STOP 1 OR 2 ASCII CHAR 

» 



SB2C 


CD8659 


ASCSJ 


CALL 


RDHLDE 


> RANGE 


5B2F 


CD2559 




CALL 


GETCH 


JFIRST CHAR 


5B32 


4F 




MOV 


CrA 




5B33 


CD2559 




CALL 


GETCH 


»2ND OR CARR RET 


5B36 


DAADSA 




JC 


SEAR2 


fONLY ONE CHAR 


5B39 


47 




MOM 


B?A 


>2ND 


5B3A 


C3B85A 




JMP 


SEAR3 





Dump a section of memory with the regular hex dump command. Then 
enter a line of ASCII characters using the new ASCII load command. 

>AL4000 <carri3de return> 

4000 This is a test of the new <cr><lf> 

ASCII load routine. <cr><lf > 

All of these characters wiU be deposited directly into memory, including the 
carriage returns and line feeds. Type a control-X to abort the task. Inspect 
the new addition first with the hex dump 

>D4000 404F 

then inspect it with the new ASCII dump: 

>AD4000 404F 

Notice the difference. The ASCII dump renders the data as it was originally 
typed. 

A carriage-return line-feed pair will cause a real carriage-return line-feed 
pair to be sent to the console. Tab characters are not expanded but are ren- 
dered as blanks (in line with our goal of reducing the monitor size). All 
other control characters are ignored. 



DEVELOPMENT OF A SYSTEM MONITOR 117 



VERSION 13: INPUT AND OUTPUT TO ANY PORT 

The load routines added in versions 4 and 12 allow us to change individual 
memory locations. And the dump routines added in versions 2 and 12 allow 
us to inspect individual memory locations. For version 13, we will add a 
routine to read any I/O port and another to send a byte to any I/O port. 
This feature will allow us to initialize and test I/O ports. 

The 8080 and Z-80 microprocessors can address 256 separate, 8-bit 
input/output ports. These ports are used for communicating with the con- 
sole, list, and tape devices. In addition, if there is a front panel, the switches 
are usually assigned to a separate data port. Also, some disk-controller 
boards use several I/O ports for communication with the CPU. 

It is more difficult to implement these I/O features on an 8080 CPU 
than on a Z-80. The reason is that the 8080 I/O instructions require the port 
address to be placed in memory immediately following the IN or OUT 
command 

BB 10 IH lOH 
D3 11 OUT IIH 

By comparison, the Z-80 can execute I/O instructions with the device 
address located in the C register. Nevertheless, we will implement the input 
and output instructions, at this time, using only 8080 code. 

The plan is to virite the IN or OUT instruction in memory, write the 
port number in the next byte, then write a RET instruction in the third 
position. A call to the address of PORTN will then produce the desired 
effect. The routine that writes these bytes in the stack area is called PUTIO. 
Since we are developing a monitor that can be placed in ROM, we will have 
to perform the actual I/O instructions outside of the regular monitor code 
area. Three bytes of memory just above the stack were previously set aside 
for this purpose. They start with the address PORTN. 

A fourth routine is also needed. Subroutine BITS is used to convert the 
binary data read from the selected port into ASCII-coded binary characters. 
An IN command then prints on the console the port data in both hex and 
binary. For example, the command 

>IFF 

will give the front-panel switch setting in both hex and binary notation. 
F8 11110000 

The BITS routine can be coded more efficiently if a Z-80 CPU is available. 
This is because the Z-80 can shift data in the general-purpose registers, as 
well as in the accumulator. This is discussed in Chapter 7. 

Change the version number to 13 and alter the branch table entries for 
the letters I and O. 
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m IPORT ilf PORT INPUT 

Dh' * OPORT tOr PORT OUTPUT 

Add the new routines to the end of the source code. Assemble version 13 
and try it out. 

Listina 6.13. Input and output to any port. 

f INPUT FROH ANY PORT (8080 VERSION) 







IPORT} 


CALL 


READHL 


rPORT 


5B40 


4D 




MOV 


CfL 


pPort to C 


5B41 


3EDB 




MVI 


ArINC 


(IN CODE 




O JU' O vj £• 




CALL 


PUTIO 


» SETUP INPUT 


JD*tO 


or 




MOV 


LfA 










CALL 


OUTLL 


JHEX VALUE 






5 

7 PRINT 


L REGISTER IN BINARY (8080 VER) 


5B4A 


0608 


5 

BITS! 


MVI 


Bf8 


58 BITS 


5B4C 


7D 


BIT2J 


MOV 


A?L 




5B4D 


87 




ADD 


A 


5 SHIFT LEFT 


5B4E 


6F 




MOV 


L»A 




5B4F 


3E18 




MVI 


Af '0'/2 


5 HALF OF 




or 




ADC 


A 


JDOUBLE+CARRY 


5B52 


i.r 1^ jc_ n W u 




CALL 


OUTT 


J PRINT BIT 


5B55 


05 




DCR 


B 




5B56 


C24C5B 




JNZ 


BIT2 


?8 TIMES 


5B59 


C9 




RET 










f 

$ OUTPUT BYTE 


FROM PORT 


(8080 VERSION) 






5 FORMAT is: 


f PORT KBYTE 


5B5A 


Cn9It59 


OPORT : 


CALL 


READHL 


IPORT 


5B5D 


4n 




MOV 


C?L 




5B5E 


CD9n59 




CALL 


READHL 


J DATA 


5B61 


3ED3 




MVI 


ArOUTC 


fOUT OPCODE 






7 

i EMULATE Z80 


INP AND OUTP FOR 8080 


5B63 


32A057 


r 

PUTIOJ 


STA 


PORTN 


SIN OR OUT CODE 


5BA6 


79 




MOV 


Af C 


5 PORT NUMBER 


5B67 


32A157 




STA 


PORTN+1 




5B6A 


3EC9 




MVI 


ApRETC 


5 RET OPCODE 


5B6C 


32A257 




STA 


PORTN+2 




5B6F 


7D 




MOV 


A;L 


5 OUTPUT BYTE 


5B70 


C3A057 




JMP 


PORTN 


? EXECUTE 



If you have a set of front panel switches, give the (Command 
>IFF 

and see if the bit pattern matches the actual switch setting. Next, try to ring 
your console bell by sending a binary 7. 
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>011 7 

The value of 11 should be changed to your console data port address if it 
is different. 

Modern serial and parallel ports need to be initialized before use. These 
initialization routines could be placed in the monitor cold-start routines. 
Initialization can also be performed with the new monitor output command. 
A Motorola 6850 serial port can be initialized for one stop bit with the two 
commands 

>010 3 <Fes©t> 
>010 15 <set> 

where 10 is the address of the status /control port. 



VERSION 14: HEXADECIMAL ARITHMETIC . 

A routine for obtaining the sum and difference of two hexadecimal numbers 
will now be added. Change the version number to 14. Change the branch 
table corresponding to the entry H. 

DW HHATH ;Hf HEX MATH 

Place the remaining new lines at the end as usual. 

Listing 6.14. Hecadeclnal addition and subtraction . 



i HEXADECIMAL MATH? SUM AND DIFFERENCE 

9 



5B73 


CD9159 


hmath: call 


HHLIiE 


9 TWO NUMBERS 


5576 


E5 


PUSH 


H 


»SAVE HrL 


5B77 


19 


DAD 


D 


fSm 


5878 


CDDF59 


CALL 


OUTHL 


SPRINT IT 


5B7B 


El 


POP 


H 




5B7C 


70 


MOV 


AfL 




5B7D 


93 


SUB 


E 


>LOW BYTES 


5B7E 


6F 


MOV 


LpA 




5B7F 


7C 


MOV 


AfH 




5B80 


9A 


SBB 


D 




5B81 


67 


HOV 


Hf A 


?HIGH BYTES 


5B82 


C3IIF59 


JMP 


OUTHL 


5 DIFFERENCE 



The new feature is executed by typing the letter H and the hex num- 
bers. The response is the sum and the difference. 

>H8000 4000 
COOO 4000 
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VERSION 15: MEMORY-TEST PROGRAM 

Back in version 6, we installed an automatic memory-size routine. This 
addition performs a memory check of sorts by testing the first byte of each 
page. In version 15, we will add a more complete memory -test program. 
Change the version number and the branch table entry for the letter J 
(justification): 

DU JUST fJf HEMORY TEST 

Then, type in the new lines as shown in Listing 6.15. 



Listing 6.15. 


A 


memory-test proslram. 








5 
» 


MEMORY TEST 










7 


THAT DOESN'T 


ALTER CURRENT BYTE 






9 


INPUT RANGE 


OF ADDRESSES? ABORT WITH " 


5B85 


CnS659 


T 

just: call 


RDHLDE 


J RANGE 


5B88 


E5 




PUSH 


H 


5 SAVE START ADDR 


tJt?OV 


yv 
/t 


JUST2: MOM 


ArM 


»GET BYTE 


5B8A 


2F 




CMA 




(COMPLEMENT IT 


5B8B 


77 




MOV 


MrA 


fPUT IT BACK 


5B8C 


BE 




CMP 


M 


fDID IT GO? 


SBSb 


C2A55B 




JNZ 


JERR 


f NO 


5B90 


2F 




CMA 




5 ORIGINAL BYTE 


5B91 


77 




MOV 


M t A 


9 PUT IT BACK 


5B92 


711 


JUST3: MOV 


A f L 


rPASS 


5B93 


93 




SUB 


E 


r COMPLETED? 


5B94 


7C 




MOV 


ArH 




5B95 


9A 




SBB 


D 




5B96 


23 




INX 


H 




5B97 


DA895B 




JC 


JUST2 


7 NO 






f 

! 


AFTER EACH PASS» 








r 


SEE IF ABORT 


WANTED 




5B9A 


CD2558 


1 


CALL 


INSTAT 


> INPUT? 


5B9D 


C41558 




CNZ 


INPUTT 


rYESf GET IT 


5BA0 


El 




POP 


H 


? START ADDR 


SBAl 


E5 




PUSH 


H 


5SAVE AGAIN 


5BA2 


C3895B 




JMP 


JUST2 


»NEXT PASS 






f 

? 


FOUND MEMORY 


ERROR » PRINT POINTER AND 






f 


BIT map: 0=GOODf 1=BAD 


BIT 


5BA5 


F5 


r 

jerr: push 


PSU 


J SAVE COMPLEMENT 


5BA6 


CDDC59 




CALL 


CRHL 


? PRINT POINTER 


5BA9 


Fl 




POP 


PSW 




5BAA 


AE 




XRA 


M 


5SET BAD BITS 


5BAB 


E5 




PUSH 


H 


fSAVE POINTER 


SBAC 


6F 




MOV 


LpA 


»BIT MAP TO L 


5BAD 


CD4A5B 




CALL 


BITS 


j PRINT BINARY 


5BB0 


El 




POP 


H 




5BB1 


C3925E 




JMP 


JUST3 


(CONTINUE 
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Assemble the program, load it into memory, and try it out. The mem- 
ory range from zero to 58FF hex is tested with the command 

>J0 5800 

This is a continuing test. The given range is tested over and over until aborted 
with a control-X command. This memory-test program is not very sophisti- 
cated. The routine will not find unusual problems in flakey, dynamic mem- 
ories. It will, however, locate those regions with no memory, protected 
memory, and grossly defective memory. The address of each bad location is 
printed in hex, then the bit pattern follows. ASCII ones are shown for the 
bad bits and ASCII zeros are given for the good bits. 

The test program gets the original memory byte, complements it, and 
puts it back. It then complements it a second time and restores the original 
byte. Thus, the original memory is left intact. The only caution here is that 
the stack area should not be tested. 

Much more sophisticated memory test programs are needed for diffi- 
cult memory errors. Of course, such programs will require a lot of memory, 
and so would not fit into a compact system monitor. One feature of such a 
program is to provide a delay between the time the test byte is placed into 
memory and the time that the byte is checked. One disadvantage of a more 
powerful memory-test program is that it does not protect the original 
memory contents. 



VERSION 16: REPLACE ONE BYTE WITH ANOTHER 

In version 11 we added a memory -search routine. This feature gives us the 
ability to find every occurrence of a particular byte. A companion feature 
added in version 16 allows us to change every occurrence of a particular byte 
to a different byte. Change the version number and the branch table corre- 
sponding to the letter R. 

m REPL fR, REPLACE 

Add the new lines shown in listing 6.16 to the end of the program. 

Listina 6>16. Replace one hex byte with another. 



5BB4 CD7C5A REPL J CALL HLDEBC 5 RANGE » 1ST BYTE 



> REPLACE HEX BYTE WITH ANOTHER 
f OVER GIVEN RANGE 

i FORMAT is: start, stop, ORIGf NEW 



5BB7 DAri459 
5BBA 41 
5BBB E5 



JC 

MOV 

PUSH 



ERROR 

BfC 

H 



J NO 2Nn 
nST TO B 



122 8080/Z-80 ASSEMBLY LANGUAGE 



SBBF 411 
5BC0 El 
5BC1 7E 
5BC2 B8 



5BBC CD9D59 



AL.L. 

HOV 

POP 

Moy 

CMP 
JNZ 
MOV 
MOM 

CMP 
JNZ 
CALL 
JMP 



READHL 

CfL 

H 

Af M 
B 

REPL3 
Mf C 
AfC 
M 

ERRB 

TSTOP 

REPL2 



J 2ND BYTE 
SINTO C 



5BCA 71 
5BC7 79 
5BC8 BE 



5BC3 C2CC5B 



REPL2J 



f FETCH BYTE 
fA MATCH? 
f NO 

^SUBSTITUTE 



5BC9 C2435A 
5BCC CD005A 
5BCF C3C15B 



REPL3J 



rSAME? 
fUOf BAD 
5 DONE? 



Assemble version 16 and try it out. Move three lines of the monitor's 
code to a lower place using the M command. 

>M5800 382F 4000 

Dump these three lines of memory with the D command. 

>D4000 402F 

Change every occurrence of the byte C3 found in those lines to a 40 hex 
using the command 

>R4000 402F C3 40 

Notice that a space must separate the two bytes C3 and 40. Now, dump this 
portion of memory with the command 

>D4000 402F 

The new byte is an ASCII "at" sign (@), therefore it will show up clearly on 
the ASCII portion of the dump. 

The replace routine can be useful for relocating a short executable 
program. Suppose that a routine is programmed for execution at 3000 hex. 
It can be moved to 4000 hex with the block-move command 

>M3000 3FFF 4000 

However, the program will not run at the new location if there are absolute 
jumps present. The high byte of each jump address -mil have to be changed 
from 30 to 40 in this case. The search routine can be used to find all occur- 
rences of 30 hex in the program. 

>S4000 4FFF 30 

Then the replace command can be given to convert each 30 hex into a 
40 hex. 



>R4000 4FFF 30 40 
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Another use for the replace command is to convert an assembly lan- 
guage source file from one format to another. For example, the CP/M 
format requires a line feed to follow a carriage return. But another assembler 
may generate lines in which only the carriage return is placed at the end of 
each line. In this case, the original file can be loaded into memory. Then, all 
of the carriage returns (OD hex) can be replaced with an ASCII character 
such as a # symbol (23 hex). 

>R100 38FF on 23 

After the file is altered with the monitor, it can be saved on a disk. The final 
step can be performed with the system editor. The global replace command 
of this editor can be used to replace every occurrence of the # sign with a 
carriage-retum/line-feed pair. With the Word-Master editor, the command 
would be 

«Mf!**AN$OTT 

The first step required the monitor because the system editors cannot 
be directed to globally change a carriage return to something else. The 
carriage-retum/line-feed pair must be treated as a unit. 



VERSION 17: COMPARE TWO BLOCKS OF MEMORY 

This last addition to our system monitor will fill out the size to just under 
IK bytes. The new routine will allow us to compare two blocks of memory. 
If discrepancies are found, the address and the contents of the appropriate 
location in both blocks will be shown. Change the version number and the 
branch table corresponding to the letter R. 

DW MERM ?M 

Add the new lines shown in Listing 6.17. 

Listing 6.17. Compare two blocks of *e»ory . 



f GIVE RANGE OF 1ST BLOCK 
} AND START OF SECOND 



5BD5 OA 
5BD6 BE 



SBDA E5 
5BDB C5 



5BD7 CAF35B 



5BD2 CD7C5A 



verm: 

VERM2: 



PUSH 
PUSH 
CALL 

Moy 

CALL 

mi 



CALL 
LDAX 
CMP 

JZ 



HLDEBC 
B 

M 

VERM3 

H 

B 

CRHL 
CfM 

OUTHEX 
Af ' J ' 



tZ ADDRESSES 
fFETCH BYTE 
fSAME AS OTHER? 

J YES 

? DIFFERENT 



5BDC CDDC59 
5BDF 4E 
5BE0 CriE459 
5BE3 3E3A 



r PRINT 1ST POINTER 
JFIRST BYTE 
»PRINT IT 
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5BE5 


C02A58 




CALL 


OUTT 










5BE8 


El 




POP 


H 




TO H 


ft 




5BE9 


CDDF59 




CALL 


OUTHL 


f SECOND POINTER 


5BEC 


4E 




MOV 


C?M 


; 2ND 


BYTE 






5BED 


CDEC59 




CALL 


OUTHX 


fPRINT IT 






5BF0 


4D 




MOV 


C»L 


? RESTORE 


C 




5BF1 


44 




MOV 


BfH 


(AND 


B 






5BF2 


El 




POP 


H 


pAND 


H»L 






5BF3 


CD005A 


VERM3J 


CALL 


TSTOP 


f DONE? 






5BF6 


03 




I NX 


B 


f 2ND 


POINTER 




5BF7 


C3D55B 




JMP 


VERM2 










The symbol table should now look like this. 










5B07 


ADMP2 


5B23 


ADMP3 


5B26 


ADMP4 




5B04 


ADUMP 


5AE0 


AL0D2 


00F7 


APOS 


5AD5 


ASCII 




5B2C 


ASCS 


0008 


BACKUP 


5B4C 


BIT2 


5B4A 


BITS 




5A09 


CALLS 


0011 


CDATA 


0011 


CDATAO 


5A3E 


CHEKM 




5809 


CIN 


5858 


COLD 


5806 


COUT 


OOOD 


CR 




59DC 


CRHL 


590F 


CRLF 


0010 


CSTAT 


0010 


CSTATO 




0008 


CTRH 


0011 


CTRQ 


0013 


CTRS 


0018 


CTRX 




007F 


DEL 


5945 


DUMP 


5948 


DUMP2 


594B 


DUMP3 




595E 


DUMP4 


5967 


DUMPS 


5A45 


ERR2 


5A43 


ERRB 




59D4 


ERROR 


5A42 


ERRP 


OOIB 


ESC 


5A5D 


FILL 




5A66 


FILL2 


5A6C 


FILL3 


5A75 


FILL4 


580F 


GCHAR 




5939 


GETC4 


5925 


GETCH 


5A08 


GO 




HEXl 




5991 


HHLDE 


5A7C 


HLDEBC 


5A8A 


HLDECK 


5B73 


HMATH 




57A5 


IBUFC 


57AA 


IBUFF 


57A3 


IBUFP 


OODB 


INC 




580C 


INLN 


0001 


INMSK 


58D5 


INPL2 


S8F1 


INPL3 




5919 


INPLB 


5901 


INPLC 


58FB 


INPLE 


58DD 


INPLI 




^ y\ 

58D0 


INPLN 


581B 


INPUT2 


5815 


INPUTT 


5825 


INSTAT 




5B3D 


IPORT 


5BA5 


JERR 


5B85 


JUST 


5B89 


JUST2 




5B92 


JUST3 


OOOA 


LF. 


5A0D 


LOAD 


5A10 


L0AD2 




5A33 


L0AD3 


5A30 


L0AD4 


5A37 


L0AD6 


5A96 


MOVDN 




5A93 


MOVE 


5AA0 


MOUIN 


5878 


MSIZE 


59C4 


NIB 




586A 


NPAGE 


0002 


OMSK 


5B5A 


OPORT 


5800 


ORGIN 




582B 


0UT2 


5839 


0UT3 


5844 


OUT 4 


00D3 


OUTC 




5812 


OUTH 


59E4 


OUTHEX 


59nF 


OUTHL 


59EC 


OUTHX 




59E3 


OUTLL 


59E7 


OUTSP 


582A 


OUTT 


5981 


PASC2 




5983 


PASC3 


5976 


PASCI 


57A0 


PORTN 


5B63 


PUT 10 




59A2 


RDHL2 


59B7 


RDHL4 


59C1 


RDHL5 


5989 


RDHLD2 




5986 


RDHLDE 


599D 


READHL 


5A4E 


REGS 


5BB4 


REPL 




5BC1 


REPL2 


5BCC 


REPL3 


5803 


RESTRT 


00C9 


RETC 




5AAD 


SEAR2 


5AB8 


SEAR3 


5ACF 


SEAR4 


5AC9 


SEARS 




5AAA 


SEARCH 


593B 


SENDM 


584F 


SIGNON 


57A0 


STACK 




5800 


START 


0009 


TAB 


589C 


TABLE 


0018 


TOP 




5A00 


TSTOP 


5BD2 


MERM 


5BD5 


VERM2 


5BF3 


VERM3 




3731 


VERS 


5861 


WARM 


5A55 


ZERO 













Try the new addition by first moving a copy of the monitor down to a lower 
memory location. 

>M5800 5BFF 4800 
Then verify that the two copies are the same. 
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>VS800 5BFF 4800 

Of course this step is not necessary, since there is a verification step included 
in the block-move routine. Change one byte in the new location so that 
there will be a difference. 

>L4820 

4820 , XX <zero location 4820> 

« • « 4X <auit> 

Then, give the verification command again. 

>V3800 5BFF 4800 

Because you changed one byte of the copy, there should be an indication 
of error. 

This compare routine completes the IK 8080 system monitor. We have 
incorporated many useful features into a minimum of space. We have care- 
fully distinguished program code from data code so that the monitor can be 
placed into ROM or PROM. 



AUTOMATIC EXECUTION OF THE MONITOR 

If you program the monitor into ROM, it will be ready to use each time the 
computer is turned on. On the other hand, you may want to copy it from 
disk into memory each time it is needed. We have been loading the monitor 
with the system debugger each time it is needed. But it is easier to include a 
short loader program at the beginning of the monitor. Then you can execute 
the monitor just by typing its name. 

A suitable loader program is given in Listing 6.18. Type the program 
into your editor. There are two locations that need to be matched to your 
monitor; these are the addresses of START and FINAL. START must corre- 
spond to the first address of your monitor. The address FINAL is the last 
address of the monitor. 



Listing 6.18, Loader prosfrs* to move the nonltor > 



5800 




START 


EOU 


5800H 


J MONITOR START 


5BFF 




FINAL 


EQU 


5BFFH 


» MONITOR END 


A920 




OFFST 


EQU 


120-START fLOAD OFFSET 


0100 




ORG 


lOOH 




5 START HERE 


0100 


210058 


9 


LXI 


Hf START 


5NEW START 


0103 


012001 




LXI 


Bf 120H 


?OLD START 


0106 


11FF5B 




LXI 


DfFINAL 




0109 


OA 


f 

LOOP J 


LDAX 


B 


fOET A BYTE 


OlOA 


77 




MOV 


Mf A 


J TO NEW PLACE 


OlOB 


BE 




CMP 


M 


)DIO IT 60? 
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OlOF 23 

0110 03 

0111 7B 

0112 95 

0113 7A 

0114 9C 



OlOC C20000 



JNZ 
INX 

INX 
MOV 
SUB 
MOM 
SBB 
JNC 
JMP 




H 
B 



Ai-E 

L 

A? D 
H 

LOOP 
START 



$N0» QUIT 
f INCREMENT 
5 POINTERS 
JDONE? 



0115 1120901 
0118 C30058 



IKEEP GOING 

5 DONE 



OllB 



END 



Assemble the loader program, then load it into memory with the debug- 
ger SID or DDT. 

A>DDT MOVE. HEX 

Next, place a copy of the monitor into memory starting at address 120 hex. 
If the monitor is already in memory, a copy can be generated with the moni- 
tor itself. DDT or SID can also be used for this task. The command is 

MS800 5BFF 120 

If the monitor resides on disk as a hex file, it can be loaded with the debug- 
ger after you calculate the offset. The offset is necessary since hex files are 
normally loaded at the operating address, but we want to put it somewhere 
else. 

The required offset should be given in the assembly listing of the 
loader program as the value of the equate OFFST. If your assembler doesn't 
print such values, then use the debugger to calculate the value. 

H120 5800 <st3rtins3 value of i»onitor> 

5920 A920 

<suH!> <difference> 

Give the commands 

IM0N17.HEX 

R<offset> 

SO that the monitor will be loaded starting at address 120 hex. 
Return to the CP/M system 

GO <3o to 2et-o> 

and save the combination 



A>SAVE 5 M0NIT0R.COM 
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From now on, all you have to do is type the command 

A>M0NITOR 

and the monitor will automatically start up. 

What actually happens is that the combination of the monitor and the 
loader program is first copied into memory at 100 hex. The move program 
relocates the monitor from address 120 hex to its proper place. Then control 
is transferred to the monitor. As each byte is moved to the new location, it 
is checked to see that it actually got there. If not, the process is terminated 
and control returns to CP/M. 

This short loader can be placed on the front of any program that must 
be relocated. Only the first two instructions may have to be changed to 
reflect the proper starting and ending addresses. 

In the next chapter, we will convert our monitor to Z-80 code. The 
Z-80 version will be smaller so that we can incorporate a few additional 
features and still be able to fit the program into IK of ROM. The features in 
the next chapter can be incorporated in the 8080 version, but they will take 
so much space that the monitor will no longer fit into IK bytes. 



CHAPTER SEVEN 

A Z-80 System, Monitor 



The system monitor developed in Chapter 6 contains many features. Since 
the size is less than 1,024 bytes, it will easily fit into a IK PROM, such as 
the 2708 EPROM. It can then be ready for use as soon as the computer is 
turned on. But, in this case, it may be necessary to include a routine to 
initialize the peripheral ports, such as those that handle the console and 
printer. In addition, you might want to send output to a printer as well as 
to the video console. If these two features are added to the monitor, the 
size will increase beyond IK bytes and it will not fit into a single IK PROM. 

One way .to add these new features without increasing the monitor's 
size is to remove some of the original routines. Another way, if you have a 
Z-80 CPU, is to convert some of the instructions to the more compact Z-80 
equivalent operations. The latter approach will be followed in this chapter. 
Listing 7.1 gives the final version with all changes discussed in this chapter. 
The symbol table at the end can be used to find the routines of interest. 



Listing 7.1 The Z-80 version of the system monitor. 

TITLE Z-80 SYSTEM MONITOR 
f (Dste aoes here) 

} FOUR SECTIONS HAVE BEEN REMOVED! 
t VERS EQU ... (1 LINE) 

i SIGNON: ... (4 LINES) 

i LXI DfSIGNON <2 LINES) 

i SENDM5 ... <6 LINES) 

I ONE SECTION HAS BEEN ADDED: 
•f LIST OUPUT ROUTINES 

0018 TOP EQU 24 S MEMORY TOP » K BYTES 

5800 ORGIN EQU (T0P~2)*1024 J PROGRAM START 



128 
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0000 



ASEG 
.Z80 
ORG 



DR6IN 



f ABSOLUTE CODE 



57A0 
0010 
0011 
0001 
0002 
0012 
0013 
0002 
0004 



STACK EQU 0RGIN-60H 
CSTAT EQU lOH 5 CONSOLE STATUS 
CDATA EQU CSTAT + 1 J CONSOLE DATA 
INMSK EQU 1 f INPUT MASK- 
OMSK EQU 2 5 OUTPUT MASK 
LSTAT EQU 12H JLIST STATUS (18) 
LDATA EQU LSTAT+1 5LIST DATA (18) 
LOMSK EQU 2 J OUTPUT MASK (IS) 
NNULS EQU A JLIST NULLS (18) 



57A0 
57A3 

57A5 
57A6 



PORTN 
IBUFP 
IBUFC 
I BUFF 



EQU 
EQU 
EQU 
EQU 



STACK 
STACK+3 

IBUFP+2 



jCONS=0»LlST=l 
J BUFFER POINTER 
J BUFFER COUNT 



IBUFP+3 f INPUT BUFFER 



0008 
0009 
0010 
0011 
0013 
0018 
0008 
007F 
00F7 
OOOD 
OOOA 



CTRH EQU 8 »"H BACKSPACE 

TAB EQU 9 f-I 

CTRP EQU 16 ?"P (18) 

CTRQ EQU 17 

CTRS EQU 19 f"S 

CTRX EQU 24 f"Xf ABORT 

BACKUP EQU CTRH J BACKUP CHAR 

DEL EQU 127 JRUBOUT 

APOS EQU (39-'0') AND OFFH 

CR EQU 13 ^CARRIAGE RET 

LF EQU 10 ?LINE FEED 



5800 C3 587E 
5803 C3 5891 



start: 



restrt: 



jp 

jp 



COLD 
WARM 



fCOLD START 
jWARM START 



f VECTORS TO USEFUL ROUTINES 



5806 C3 S835 
5809 C3 5815 
580C C3 58FD 
580F C3 5949 
5812 C3 59F8 



C0UT5 

cin: 

INLN2 
GCHAR! 

outh: 



JP 
JP 
JP 
JP 
JP 



outt 

INPUTT 
INPLN 
6ETCH 
OUTHX 



J OUTPUT CHAR 
; INPUT CHAR 
? INPUT LINE 
J GET CHAR 
5BIN TO HEX 



» CONSOLE INPUT ROUTINE 

f CHECK FOR CONTROL-Pr LIST TOGGLE 



5815 CD 5827 
5818 28 FB 
581 A DB 11 
581C E6 7F 
581E FE 18 
5820 28 DE 
5822 FE 10 
5824 28 06 
5826 C9 



INPUTT J CALL 
JR 

INPUT2J IN 
AND 
CP 
JR 
CP 
JR 
RET 



INSTAT ? CHECK STATUS 

Zf INPUTT »NOT READY 
A> (CDATA) JQET BYTE 
DEL 

CTRX 5 ABORT? 
Z» START I YES 
CTRP j"P? 
ZfSETLST 5LIST 



} GET CONSOLE-INPUT STATUS 



130 8080/Z-80 ASSEMBLY LANGUAGE 



5827 


DB 


10 


instat: 


IN 


Af <CSTAT) 




E6 


01 




AND 


INHSK 


582B 


C9 






RET 










\ TOGGLE LIST 


OUTPUT WITH CONTROL~P 


582C 


3A 


57A0 


setlst: 


LD 


A» (PORTN) fCHECK FLAG 


582F 


2F 






CPL 


5 INVERT 


5830 


32 


57A0 




LD 


<PORTN)?A J SAVE 


5833 


18 


EO 




JR 


INPUTT JNEXT BYTE 








J CONSOLE OUTPUT ROUTINE 


5835 


F5 




OUTT J 


PUSH 


AF 


5836 


3A 


57A0 




LD 


Aj<PORTN) fWHERE? 


5839 


B7 






OR 


A 5ZER0? 


S83A 


20 


IF 




JR 


NZ,LOUT 5LIST OUTPUT 


583C 


CD 


5827 


0UT2J 


CALL 


INSTAT y INPUT? 


5B3F 


28 


10 




JR 


ZrOUT4 5 NO 


5841 


CD 


581A 






INPUT2 fGET INPUT 


5844 


FE 


13 




CP 


CTRS } FREEZE? 


5846 


20 


F4 




JR 


NZrOUT2 5 NO 


5848 


CD 


5815 


0UT35 


CALL 


INPUTT 5 INPUT? 


584B 


FE 


11 




CP 


CTRQ f RESUME? 






F9 




JR 


NZfOUT3 J NO 


584F 


18 


EB 




JR 


0UT2 




IMS 




0UT4J 


IN 


Af <CSTAT) J GET STATUS 


5853 


E6 


02 




AND 


OMSK 


5855 


28 


E5 




JR 


ZrOUT2 5 NOT READY 




Ft 






POP 


AF 


5858 


D3 


11 




OUT 


(CDATA) »A rSEND DATA 


585A 


C9 






RET 










i 

f LIST 


OUTPUT 


ROUTINE 








1 SEND 


TO CONSOLE TOO 


585B 


CD 


5827 


9 

LOUT! 




INSTAT J INPUT? 


585E 


C4 


581A 




CALL 


NZrINPUT2 JYES» GET IT 


ooo X 


titt 

JLIJt> 




f 


IN 


Af (LSTAT) JCHECK STATUS 


5863 


E6 


02 




AND 


OMSK 


5865 


28 


F4 




JR 


ZfLOUT fNOT READY 


5867 


Fl 






POP 


AF 


5868 


D3 


13 




OUT 


(LDATA) »A J SEND DATA 


586A 


D3 


11 




OUT 


(CDATA)jA f CONSOLE TOO 


586C 


E6 


7F 




AND 


7FH JMASK PARITY 








i ADD TIME DELAY AFTER CARRIAGE RETURN 


586E 


FE 


OD 


f 


CP 


CR » CARRIAGE RET? 


5870 


CO 






RET 


NZ »N0 


5871 


D5 






PUSH 


DE ?USE DrE 


5872 


16 


78 




LD 


D»30 * NNULS 


5874 


IE 


FA 


outcr: 


LD 


E»250 


5876 


ID 




0UTCR2: 


DEC 


E 


5877 


20 


FD 




JR 


NZfOUTCR2 J INNER LOOP 


5879 


15 






DEC 


D 
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587A 20 F"8 
587C Dl 
587D C9 



587E 31 57A0 



5881 3E 03 
5883 D3 10 
5885 D3 12 
5887 3E 15 
5889 D3 10 
588B D3 12 
588D AF 
588E 32 57A0 



5891 21 5891 
5894 E5 



JR 

POP 

RET 



NZfOUTCR 
DE 



5 OUTER LOOP 
7 RESTORE 



f CONTINUATION OF COLD START 

5 

COLD J LD SP> STACK 

f 

5 INITIALIZE I/O PORTS 



LD 
OUT 
OUT 
LD 

OUT 
OUT 
XOR 
LD 



Ar3 

(CSTAT)fA 
(LSTAT) f A 

A»15H 
<CSTAT)?A 
(LSTAT) f A 

A ;get 

(PORTN) »A 



PRESET 



fSET 

A ZERO 

JRESET 



WARM-START ENTRY 



warm: LD HLfWARM 5 RET TO 

PUSH HL i HERE 

5 FIND TOP OF USABLE MEMORY. 

f CHECK FIRST BYTE OF EACH PAGE OF MEMORY 

$ STARTING AT ADDRESS ZERO. STOP AT STACK 

f OR MISSING/DEFECTIVE/PROTECTED MEMORY. 

» DISPLAY HIGH BYTE OF MEMORY TOP. 



5895 


21 


0000 




LD 


HL»0 


5 PAGE ZERO 


5898 


06 


57 




LD 


BfHIGH STACK JSTOP HERE 


589A 


7E 




npage: 


LD 


Af (HL) 


fGET BYTE 


589B 


2F 






CPL 




? COMPLEMENT 


589C 


77 






LD 


(HL) f A 


»PUT IT BACK 


589D 


BE 






CP 


(HL) 


JSAME? 


589E 


20 


05 




JR 


NZfMSIZE 


$NOr MEM TOP 


58A0 


2F 






CPL 




?0RI6 BYTE 


58A1 


77 






LD 


(HL) rA 


JRESTORE IT 


58A2 


24 






INC 


H 


JNEXT PAGE 


58A3 


10 


F5 




DJNZ 


NPAGE 


5 KEEP GOING 


58A5 


4C 




MSIZEJ 


LD 


C»H 


{MEM TOP 


S8A6 


CD 


5935 




CALL 


CRLF 


;neu line 


58A9 


CD 


59F8 




CALL 


OUTHX 


f PRINT MEM SIZE 


58AC 


CD 


58FD 




CALL 


INPLN 


; CONSOLE LINE 


58AF 


CD 


5949 




CALL 


GETCH 


5 FIRST CHAR 








9 

t MAIN 


COMMAND 


PROCESSOR 




58B2 


D6 


41 


> 


SUB 


'A' 


{CONVERT OFFSET 


58B4 


DA 


59E0 




JP 


CjERROR 


{ < A 


58B7 


FE 


lA 




CP 


'Z'-'A'+l 


58B9 


D2 


59E0 




JP 


NC 7 ERROR 


J > Z 


58BC 


87 






ADD 


ArA 


{DOUBLE 


58BD 


21 


58C9 




LD 


HLf TABLE 


{START 


58C0 


16 


00 




LD 


D,0 




58C2 


5F 






LD 


E>f\ 


{OFFSET 


58C3 


19 






ADD 


HL»DE 


{ADD TO TABLE 
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58C4 


5E 




LD 


E» <HL) 


H.QU BYTE 


58C5 


23 




INC 


HL 






58CA 


56 




LD 


D? (HL) 


tHIgh byte 


58C7 


EB 




EX 


DErHL 


fINTO HfL 


58C8 


E9 




JP 


(HL) 


J GO 


THERE 






r 
$ 


COHMAND TABLE 








58C9 


5Ari3 


TABLE? DM 


ASCII 




DUMP f LOAD 


5SCB 


59E0 




m 


ERROR 


ih 




58CII 


5A15 




nw 


CALLS 


iCt 


SUBROUTINE 


5BCF 


595E 




DU 


DUMP 


r D ? 


DUMP 


58D1 


59E0 




m 


ERROR 


5 E 




S8D3 


5A64 




m 


FILL 


p F p 


MEMORY 


58D5 


SA14 




nw 


GO 


? G ? 


GO 


58D7 


5B51 




DU 


HMATH 


f H » 


HEX MATH 


58D9 


5B31 




m 


I PORT 


? I ? 


PORT INPUT 


58DB 


5B60 




m 


JUST 


1 J p 


MEMORY TEST 


581111 


59E0 




DU 


ERROR 


fK 




58DF 


5A19 




DW 


LOAD 


5 L p 


LOAD 


58E1 


5A97 




DU 


HOVE 


iHf 


MEMORY 


58E3 


59E0 




DU 


ERROR 


IN 




58E5 


5B47 




DU 


OPORT 


lOr 


PORT OUTPUT 


58E7 


59E0 




DU 


ERROR 


?P 




58E9 


59E0 




DU 


ERROR 


?Q 




58EB 


5B8C 




m 


REPL 


5Rf 


REPLACE 


58ED 


5AAD 






SEARCH 


f S f 


MEMORY 


58EF 


59E0 




DU 


ERROR 


fl 




58F1 


59E0 




m 


ERROR 






58F3 


5BA8 




DU 


VERM 




VERIFY MEM 


58F5 


59E0 




DU 


ERROR 


iu 




58F7 


5A5(S 




DU 


REGS 


S X p 


STK PNTR 


58F9 


59E0 




DU 


ERROR 


? Y 




58FB 


5A5D 




DU 


ZERO 


5Z» 


MEMORY 



5 

i INPUT A LINE FROM CONSOLE AND PUT IT 

5 INTO THE BUFFER. CARRIAGE RETURN ENDS 

» THE LINE. RUBOUT OR "H CORRECTS LAST 

f LAST ENTRY. CONTROL~X RESTARTS LINE. 

i OTHER CONTROL CHARACTERS ARE IGNORED 



58FD 


3E 


3E 


inpln: 


LD 


A 9 ' > ' 


» PROMPT 


58FF 


CD 


5835 




CALL 


OUTT 




5902 


21 


57A6 


INPL2: 


LD 


HLpIBUFF 


J BUFFER ADDR 


5905 




57A3 




LD 


( IBUFP) ? 


HL J SAVE POINTER 


5908 


OE 


00 




LD 


CpO 


J COUNT 


590A 


CD 


5815 


INPLI 5 


CALL 


INPUTT 


> CONSOLE CHAR 


590D 


FE 


20 




CP 




p CONTROL? 


590F 


38 


18 




JR 


CrINPLC 


pYES 


5911 


FE 


7F 




CP 


DEL 


pDELETE , . 


5913 


28 


2A 




JR 


Zf INPLB 


fYES 


5915 


FE 


5B 




CP 


' Z ' 4" 1 


SUPPER CASE? 


5917 


38 


02 




JR 


C»INPL3 


pYES 


5919 


E6 


5F 




AND 


5FH 


pMake upper 


591B 


77 




INPL3: 


LD 


(HL) pA 


pInto buffer 


591C 


3E 


20 




LD 


Ap32 


f BUFFER SIZE 


591E 


B9 






CP 


C 


pFULL? 


591F 


28 


E9 




JR 


Zf INPLI 


f yesp loop 
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5921 


7E 




LD 


A> <HL) »GET CHAR 


5922 


23 




INC 


HL jINCR POINTER 


5923 


OC 




INC 


C 5 AND COUNT 


5924 


CD 


5835 


inple; call 


OUTT J SHOW CHAR 




1 a 


t. 1 


JR 


INPLI fNEXT CHAR 








9 

f PROCESS CONTROL CHARACTER 


5929 


FE 


08 


If 

INPLCI CP 


CTRH ;"H? 


592B 


28 


12 


JR 


Zf INPLB > YES 


5921D 


FE 


OD 


CP 


CR » RETURN? 


592F 


20 


D9 


JR 


NZ» INPLI fHOf IGNORE 








f 

i END OF INPUT 


LINE 


5931 


79 




i 

LD 


AjC 5 COUNT 


5932 


32 


57A5 


LD 


(IBUFOfA fSAVE 








f 

i CARRIAGE-RETURNf LINE-FEED ROUTINE 


5935 


3E 


OD 


CRLF} LD 


A?CR 


5937 


CD 


5835 


CALL 


OUTT f SEND CR 


593A 


3E 


OA 


LD 


A»LF 


593C 


C3 


5835 


JP 


OUTT f SEND LF 








•f DELETE PRIOR 


CHARACTER IF ANY 


593F 


79 




inplb: LD 


A.C 5CHAR COUNT 


5940 


B7 




OR 


A fZERO? 


5941 


28 


C7 


JR 


ZrlNPLI pYES 


5943 


2B 




DEC 


HL 5 BACK POINTER 


5944 


OD 




DEC 


C J AND COUNT 


5945 


3E 


08 


LD 


A f BACKUP ^CHARACTER 


5947 


18 


DB 


JR 


INPLE 5SEND 








) GET A CHARACTER FROM CONSOLE BUFFER 








i SET CARRY IF 


EMPTY 


5949 


E5 




> 

getch: push 


HL fSAME REDS 


594A 


2A 


57A3 


LD 


HLr < IBUFP) ;GET POINTER 


594D 


3A 


57A5 


LD 


Ap(IBUFC) 5AND COUNT 


5950 


06 


01 


SUB 


1 IDECR WITH CARRY 


5952 


38 


08 


JR 


CfGETC4 5N0 MORE CHAR 


5954 


32 


57A5 


LD 


< IBUFC) f A JSAVE NEW COUNT 


5957 


7E 




LD 


Af (HL) J GET CHARACTER 


5958 


23 




INC 


HL fINCR POINTER 


5959 


22 


57A3 


LD 


<IBUFP)»HL 5 AND SAVE 


595C 


El 




GETC4 5 POP 


HL f RESTORE REGS 


595D 


C9 




RET 










) DUMP MEMORY IN HEXADECIMAL AND ASCII 


595E 


CD 


5999 


y 

dump; call 


RDHLDE ? RANGE 


5961 


CD 


59E8 


DUMP2; call 


CRHL JNEW LINE 


5964 


4E 




DUHP3: LD 


Cj (HL) fGET BYTE 


5965 


CD 


59F8 


CALL 


OUTHX fPRINT 


5968 


23 




INC 


HL J POINTER 


5969 


7D 




LD 


ArL 
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596A 


E6 


OF 




Mix it 


vr n 




596C 


'•JO 


A"? 
O / 




IP 


7 » X\\ IMP 4 


SYF<^» A'=!ril 


59AE 


E.6 


Oo 








r OF M4wE_ 


5970 


LL 


ir- o CT "2 






JL r KJiJ i or 






1 o 


ETC* 

fcr 




ulrC 


fll BMP'X 
iflUi ir o 


5NFXT HFX 

F It C. A 1 r 1 K. A 


5975 


CD 


KT r* t" "y 

59F3 


UUnr 4 » 




ni ITGP 
UU 1 or 




5978 


LID 












5979 


11 


FFFO 




LD 


DEf-IOH 


fReset line 


597C 


19 






ADD 


HLfDE 




59 7D 


ni 






POP 


DE 




597E 


CD 


598B 


DUMPS : 


CALL 


PASCI 


F ASCII DUMP 


5981 


CD 


5A0C 




CALL 


TSTOP 


fDONE? 


5984 


7D 






LD 


AfL 


fNO 


5985 


E6 


OF 




AND 


OFH 


5LINE END? 


5987 


20 


F5 




JR 


NZf DUMPS 


fNO 


5989 


18 


D6 




JR 


DUMP2 










F DISPLAY MEMORY BYTE IN 


ASCII IF 








i POSSIBLE r OTHERWISE GIVE DECIMAL PNT 


598B 


7E 




O A o n T • 


LD 


A F ( HL ) 


f GET BYTE 


598C 


r t 


/r 




CP 


DEL 


fHigh bit on? 










JR 


NCfPASC2 


fYES 


oWO 


r t 






CP 




F CONTROL CHAR? 




oU 






JR 


NCfPASC3 


$N0 


D7Y*t 


Oil 


op 


PASC2 5 


LD 


Af ' . ' 


; CHANGE TO DOT 


ROD Z 

5996 




trait: 


PASC3: 


JP 


OUTT 


fSEND 








i GET H 


fL and d 


fE from CONSOLE 








F CHECK 


THAT Df 


E IS LARGER 


5999 


CD 


59A3 


RDHLDEt 


CALL 


HHLDE 




599C 


7B 




RDHLD2J 


LD 


A F E 




599D 


95 






SUB 


L 


5E - L 


599E 


7A 






LD 


AfD 




599F 


9C 






SBC 


AfH 


fD - H 


59A0 


38 


3E 




JR 


Cf ERROR 


5HfL bigger 


59A2 


C9 






RET 












p 

5 INPUT 


HfL and 


DfE 




59A3 


CD 


59AE 


hhlde: 


CALL 


READHL 


»HfL 


59A6 


38 


38 




JR 


Cf ERROR 


5 ONLY 1 ADDR 


59A8 


EB 






EX 


DEfHL 


ISAUE IN DfE 


59A9 


CD 


59AE 




CALL 


READHL 


fDfE 


59AC 


EB 






EX 


DEfHL 


>PUT BACK 


59AD 


Lt 






RET 












F INPUT 


HfL FROM CONSOLE 


59AE 


HO 




1 

READHLJ 


PUSH 


DE 




59AF 


C5 






PUSH 


BC 


fSAVE REGS 


59B0 


21 


0000 




LD 


HLfO 


F CLEAR 


59B3 


CD 


5949 


RDHL2J 


CALL 


GETCH 


>GET CHAR 


59B6 


38 


15 




JR 


CfRDHLS 


fLINe end 


59B8 


CD 


59D0 




CALL 


NIB 


fTO binary 


59BB 


38 


08 




JR 


CfRDHL4 


fNOT hex 


59BD 


29 






ADD 


HLfHL 


> SHIFT LEFT 


59BE 


29 






ADD 


HLfHL 


5 FOUR 
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59BF 29 
59C0 29 
59C1 B5 
59C2 
59C3 



6f 

18 EE 



ADD 

ADD 

OR 

LD 

JR 



HL r HL 
HLf HL 

L 

RDHL2 



i BYTES 

rADD NEW CHAR 

>NEXT 



i CHECK FOR COMMA OR BLANK AT END 



59C5 


FE 


F7 


RDHL4; 


CP 


APOS 


5 APOSTROPHE 


59C7 


28 


04 




JR 


ZfRDHLS 


f ASCII INPUT 


59C9 


FE 


FO 




CP 


( ' '-'0' ) AND OFFH 


59CB 


20 


13 




JR 


NZf ERROR J NOT BLANK 


59CD 


CI 




RDHL5J 


POP 


BC 




'=i9rF 


Dl 






POP 


DE 


; RESTORE 


59CF 


C9 






RET 












} CONVERT ASCII 


CHARACTERS TO BINARY 


59D0 


D6 


30 


? 

NIBS 


SUB 


'0' 


; ASCII BIAS 


59D2 


D8 






RET 


C 


5 < 


59D3 


FE 


17 




CP 


'F'-'O' 


+ 1 


59D5 


3F 






CCF 




f INVERT 


59D6 


D8 






RET 


C 


» ERROR p > F 


5907 


FE 


OA 




CP 


10 




59D9 


3F 






CCF 




i INVERT 


59DA 


DO 






RET 


NC 


5 NUMBER 0-9 


59DB 


B6 


07 




SUB 


'A'-'9' 


-1 


59DD 


FE 


OA 




CP 


10 


fREMOVE :- 


59DF 


C9 






RET 




f LETTER A-F 








r 

; PRINT 


? ON IMPROPER INPUT 


59E0 


3E 


3F 


5 

ERROR : 


LD 


As '?' 




59E2 


CD 


5835 




CALL 


OUTT 




59E5 


C3 


5800 




JP 


START 


»TRY AGAIN 








> 

f START 


NEW LINE; GIVE 


ADDRESS 


59E8 


CO 


5935 


crhl: 


CALL 


CRLF 


fNEU LINE 








f' 

•f PRINT 


HfL IN 


HEX 




59EB 


4C 




outhl: 


LD 


CfH 




59EC 


CD" 


59F8 




CALL 


OUTHX 


pH 


59EF 


4D 




OUTLLJ 


LD 


CfL 










t 

f OUTPUT HEX BYTE FROM 


C AND A SPACE 


59F0 


CD 


59F8 


y 

OUTHEX J 


CALL 


OUTHX 










T 

f OUTPUT A SPACE 




59F3 


3E 


20 


f 

OUTSPS 


LD 


A»' ' 




59F5 


C3 


5835 




JP 


OUTT 





i OUTPUT A HEX BYTE FROM C 

5 BINARY TO ASCII HEX CONVERSION 
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59F8 


79 






A ■ p 


59F9 


IF 




RRA 


! RriTATF 
f i\\J 1 n 1 c 


59FA 


IF 




RRA 


! trni IP 


59FB 


IF 




RRA 


? u X 1 O 1 U 


59FC 


IF 




RRA 


> RIGHT 


59FD 


CD 


5A01 


CALL 


HEXl SUPPER CHAR 


5A00 


79 




LD 


A a it ni.icci r*uAtri 
HJU i>uU«lc.h LHhK 


5A01 


E6 


OF 


HEXll AND 


OFH » TAKE 4 BITS 


SA03 


C6 


90 


ADD 


Af 90H 


=iAOS 






Uftft 


?dar trick 


5MA 


CE 


40 
















5A09 




vj O \3 \J 


IP 


niiTT 
UU 1 i 








5 CHECK FOR END 










? INCREMENT H?L 




5A0C 


23 




tstop: INC 


HL 


5A0D 


7B 




LD 


A » E 


5A0E 


95 




SUB 


L S E ~ L 


5A0F 


7A 




LD 


Af D 


5A10 


9C 




SBC 


A»H > D - H 


5A11 


DO 




RET 


NC 5 NOT DONE 


SA12 


El 




POP 


HL J RAISE STACK 


«Jri JL t3 






RET 










f 

f ROUTINE TO GO 


ANYWHERE IN MEMORY 








> FOR CALL ENTRY f ADDRESS OF WARM 








f IS ON STACK r 1 


SO A SIMPLE RET 








i WILL RETURN TO THIS MONITOR 


5A14 


El 




¥ 

GO J POP 


HL 5 RAISE STACK 


5A15 


CD 


59AE 


calls: call 


READHL f GET ADDRESS 


5A18 


E9 




Jp 


(HL) 5 GO THERE 








f LOAD HEX OR ASCII CHAR INTO MEMORY 








t FROM CONSOLE. 


CHECK TO SEE IF 








i THE DATA ACTUALLY GOT THERE 








} APOSTROPHE PRECEEDS ASCII CHAR 








» CARRIAGE RET 


PASSES OVER LOCATION 


5A19 


CD 


59AE 


9 

LOADS CALL 


READHL J ADDRESS 




CD 


59EB 


L0AD2.' CALL 


OUTHL ; PRINT IT 


5A1F 


CD 


598B 


C AL. L. 


PASCI PASCII 


5A22 


CD 


59F3 


CALL 


OUTSP 


5A25 


4E 




LD 


C? (HL) f ORIG BYTE 


5A26 


CD 59F0 


CALL 


OUTHEX 5 HEX 


5A29 


E5 




PUSH 


HL 5 SAME PNTR 


5A2A 


CD 


5902 


CALL 


INPL2 J INPUT 


5A2ri 


CD 


59AE 


CALL 


READHL 9 BYTE 


5A30 


45 




LD 


BfL s TO B 


5A31 


El 




POP 


HL 


5A32 


FE 


F7 


CP 


APOS 


5A34 


28 


OA 


JR 


ZfL0AD6 f ASCII INPUT 


5A36 


79 




LD 


AfC f HOW MANY? 


5A37 


B7 




OR 


A fNONE? 


SA38 


28 


03 


JR 


2 f LOADS 5 YES 
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SA3A 


CD 


5A46 


L0AD4 J 


CALL 


CHEKM 


>INTO MEMORY 


5A3D 


23 




L0AD3 : 


INC 


HL 


r POIN 1 cR 


5A3E 


18 


DC 




JR 


L0AD2 










f LOAD 


ASCII CHARACTER 




5A40 


CD 


5949 


L0AD6I 


A L- 1- 


GETCH 




5A43 


47 






LD 


Bp A 




5A44 


18 


F4 




JR 


L0AD4 










5 COPY 


BYTE FROM B TO MEMORY 








i AND SEE THAT 


IT GOT THERE 


5A46 


70 




y 

chekm: 


LD 


(HL) i-B 


5 PUT IN MEM 


5A47 


7E 






LD 


A? <HL) 


?6ET BACK 


5A48 


BB 






CP 


B 


J SAME? 


5A49 


CB 






RET 


Z 


>0K 


5A4A 


Fl 




ERRP5 


POP 


AF 


(RAISE STACK 


5A4B 


3E 


42 


ERRBJ 


LD 


Af 'B' 


(BAD 


5A4D 


CD 


5835 




CALL 


OUTT 




5A50 


CD 


59F3 




CALL 


OUTSP 




5A53 


C3 


59EB 




JP 


OUTHL 


(POINTER 








I DISPLAY STACK POINTER 


REGISTER 


5A56 


21 


0000 


9 

REGS J 


LD 


HLi-0 




5A59 


39 






ADD 


HLs-SP 




5A5A 


C3 


59EB 




JP 


OUTHL 










f ZERO 


A PORTION OF MEMORY 


SA5D 


CD 


5999 


f 

ZEROS 


CALL 


RDHLDE 


(RANGE 


5A60 


06 


00 




LD 






5A62 


18 


08 




JR 


FILL2 










; FILL 


A PORTION OF MEMORY 


5A64 


CD 


5A80 


f 

fill; 


CALL 


HLDEBC 


(RANGE? BYTE 


5A67 


FE 


F7 




CP 


APOS 


(APOSTROPHE? 


5A69 


28 


OF 




JR 


Z»FILL4 


(YESf ASCII 


5A6B 


41 






LD 


B»C 




5A6C 


7C 




FILL2; 


LD 


A;H 


(FILL BYTE 


5A&II 


FE 


57 




CP 


HIGH STACK 5 TOO FAR? 


5A(&F 


D2 


59E0 




JP 


NCrERROR 5 YES 


5A72 


CD 


5A46 


FILL3: 


CALL 


CHEKM 


(PUT» CHECK 


5A75 


CD 


SAOC 




CALL 


TSTOP 


(DONE? 


5A78 


18 


F2 




JR 


F1LL2 


(NEXT 


5A7A 


CD 


5949 


FILL4I 


CALL 


GETCH 


(ASCII CHAR 


5A7D 


47 






LD 


BrA 




5A7E 


18 


F2 




JR 


FILL3 










1 

5 GET 


HfL DfE 


AND BfC 




5A80 


CD 


5A8E 


? 

HLDEBC; CALL 


HLDECK 


(RANGE 


5A83 


DA 


59E0 




JP 


Cf ERROR 


(NO BYTE 


5A86 


E5 






PUSH 


HL 





138 8080/Z-80 ASSEMBLY LANGUAGE 



5A87 


CD 


59AE 




CALL 


READHL ?3RD INPUT 


5A8A 


44 






LD 


b»h J move to 


5A8B 


4D 






LD 


C»L » B»C 


5A8C 


El 






POP 


HL 


5A8D 


C9 






RET 










f 

f GET 2 


ADDRESSES f CHECK THAT 








) ADDITIONAL 


DATA IS INCLUDED 


1-iNOC 


L/JLf 


vj T HO 


hldeck: 


CALL 


HHLDE 5 2 ADDR 


5A91 




«J 7 C V 




JP 


Cr ERROR ; THAT'S ALL 


5A94 


C3 


599C 




JP 


RDHLD2 » CHECK 








f MOVE 


A BLOCK OF MEMORY HjL-DpE TO B,C 


5A97 


cn 


5A80 


9 

move: 


CALL 


HLDEBC 5 3 ADDR 


5A9A 


CD 


5AA3 


movdn: 


CALL 


MOVIN 5 MOVE/CHECK 


5A9n 


CD 


5A0C 




CALL 


TSTOP 5 DONE? 


5AA0 


03 






INC 


BC 5 NO 


5AA1 


18 


F7 




JR 


MOMDN 


5AA3 


7E 




MOMINJ 


LD 


Af (HL) IBYTE 


5AA4 


02 






LD 


(BC)fA INEW LOCATION 


5AA5 


OA 






LD 


Ar (BC) ; CHECK 




BE 






CP 


(HL) »IS IT THERE? 




C8 






RET 


Z 5 YES 


5AA8 


60 






LD 


H»B 5 ERROR 


5AA9 


69 






LD 


LfC {INTO HfL 


SAAA 


C3 


SA4A 




JP 


ERRP 5 SHOW BAD 








> SEARCH FOR 


1 OR 2 BYTES OVER THE 








} RANGE 


H»L D 


ft:, BYTES ARE IN B,C 








f B HAS 


CARRIAGE RETURN IF ONLY ONE BYTE 








5 PUT SPACE BTWEEN BYTES IF TWO 








; format; start stop bytei byte2 


5AAn 


CD 


5A80 


search? 


CALL 


HLDEBC IRANGE^ 1ST BYTE 


5AEI0 


06 


OD 


SEAR2; 


LD 


BfCR $SET FOR 1 BYTE 


5AB2 


38 


06 




JR 


Cf SEARS 5 ONLY ONE 


5AB4 


E5 






PUSH 


HL 


5AB5 


CD 


59AE 




CALL 


READHL 5 2ND BYTE 


5AB8 


45 






LD 


BrL JINTO C 


5AB9 


El 






POP 


HL 


SABA 


7E 




SEAR3I 


LD 


Aj (HL) rGET BYTE 


5ABB 


B9 






CP 


C JMATCH? 


5ABC 


20 


10 




JR 


NZ»SEAR4 INO 


5ABE 


23 






INC 


HL f YES 


5ABF 


78 






LD 


A>B fONLY 1? 


5AC0 


FE 


OD 




CP 


CR 


5AC2 


28 


04 




JR 


Zr SEARS ; YES 








9 

f FOUND 


FIRST 


MATCH? CHECK FOR SECOND 


5AC4 


7E 




f 


LD 


Ar (HL) JNEXT BYTE 


5AC5 


B8 






CP 


B » MATCH? 


5AC6 


20 


06 




JR 


NZrSEAR4 5 NO 
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5AC8 


2B 




btAKD > 


DEC 


HL 


J A MATCH 


5AC9 


C5 






PUSH 


DC 




5ACA 


CD 


59E8 




CALL 


CRHL 


fSHOW ADDR 


5ACD 


CI 






POP 


BC 




5ACE 


CD 


5A0C 


SEAR4 : 


CALL 


TSTOP 


5 DONE? 


5AD1 


18 


E7 




JR 


SEAR3 


>N0 








f 

} ASCII 


SUB-COMMAND PROCESSOR 


5AD3 


CD 


5949 


> 

ASCIIJ 


CALL 


GETCH 


9 Nt A i LHHK 


5An6 


FE 


44 




CP 


'D' 


9 Dior LAY 


5AD8 


28 


24 




JR 


Zf ADUMP 




5ADA 


FE 


53 




CP 


'S' 


• O IT" A Tl I i 

r SEARCH 


5ADC 


28 


42 




JR 


2f ASCS 




5ADE 


FE 


4C 




CP 


'L' 




5AE0 


C2 


59E0 




JP 


NZ, ERROR 










5 

} LOAD 


ASCII 


CHARACTERS 


INTO MEMORY 








•f QUIT 


ON CONTROL-X 




5AE3 


CD 


59AE 


> 


CALL 


READHL 


$ADDRESS 


5AE6 


CD 


59EB 




CALL 


OUTHL 


JPRINT IT 


5AE9 


CD 


5815 


AL0D2J 


CALL 


INPUTT 


fNext char 


5AEC 


CD 


5835 




CALL 


OUTT 


; PRINT IT 


5AEF 


47 






LD 


D> A 


5 SAVE 


5AF0 


CD 


5A46 




CALL 


CHEKM 


J INTO MEMORY 


5AF3 


23 






INC 


HL 


5P0INTER 


5AF4 


7D 






LD 


ArL 




5AF5 


E6 


7F 




AND 


7FH 


?LINE END? 


5AF7 


20 


FO 




JR 


NZ>AL0D2 




5AF9 


CD 


59E8 




CALL 


CRHL 


;NEW LINE 


5AFC 


18 


EB 




JR 


AL0D2 





f 

•f DISPLAY MEMORY IN STRAIGHT ASCII. 

} KEEP CARRIAGE RETURN. LINE FEED. CHANGE 

) TAB TO SPACE. REMOVE OTHER CONTROL CHAR. 

J 



SAFE 


CD 


5999 


adump: 


CALL 


RDHLDE 


S RANGE 


5B01 


7E 




ADMP2 : 


LD 


A. (HL) 


fGET BYTE 


5B02 


FE 


7F 




CP 


DEL 


;high bit on? 


5B04 


30 


15 




JR 


NC.ADMP4 


5 YES 


5B06 


FE 


20 




CP 




.CONTROL? 


5B08 


30 


OE 




JR 


NC.ADMP3 


5 NO 


5B0A 


FE 


OD 




CP 


CR 


fCARR RET? 


5B0C 


28 


OA 




JR 


Zf ADMP3 


; YES. OK 


5B0E 


FE 


OA 




CP 


LF 


5LINE FEED? 


5B10 


28 


06 




JR 


Z.ADMP3 


J YES. OK 


5B12 


FE 


09 




CP 


TAB 




5B14 


20 


05 




JR 


NZ.ADMP4 


jSKIP OTHER 


5B16 


3E 


20 




LD 


A. ' ' 


f SPACE FOR TAB 


5B18 


CD 


5835 


ADMP3: 


CALL 


OUTT 


$SEND 


SBIB 


CD 


5A0C 


ADMP4I 


CALL 


TSTOP 


SDONE? 


5B1E 


18 


El 




JR 


ADMP2 





} SEARCH FOR 1 OR 2 ASCII CHARACTERS 
f NO SPACE BETWEEN ASCII CHARS 

. format; start stop i or 2 ascii char 
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5B20 


CD 


5999 


Ascs: 


CALL 


RDHLDE 


SRANGE 


5B23 


CD 


5949 




CALL 


GETCH 


IFIRST CHAR 




4F 
•ti 






LD 


C,A 




5B27 


CD 


5949 




CALL 


GETCH 


f2ND OR CARR RET 


5B2A 


DA 


5AB0 




JP 


Cf SEAR2 


fONLY ONE CHAR 


5B2ri 


47 






LD 


B? A 


f2ND 


5B2E 


C3 


SABA 




JP 


SEARS 










f 

f INPUT 


FROM 


ANY PORT (Z-80 VERSION) 




r*n 


vjy He, 


s 

T pnPT ♦ 


CALL 


READHL 


JPORT 










LD 


CfL 


JPORT TO C 




cii 


6o 




IN 


Lp <C) 


? INPUT 










CALL 


OUTLL 


5 HEX VALUE 








» PRINT 


L REGISTER IN B 


INARY (Z-80 VER) 


sJ O M 






BITS! 


LD 


B;8 


58 BITS 


5B3C 


CB 


25 


BIT2S 


SLA 


L 


fSHIFT L LEFT 


5B3E 


3E 


18 




LD 


Af '0'/2 


fHALF OF 


5B40 


8F 






ADC 


ArA 


pDOUBLE+CARRY 


5B41 


CD 


5835 




CALL 


OUTT 


SPRINT BIT 


5B44 


10 


F6 




DJNZ 


BIT2 


58 TIMES 


5B46 


C9 






RET 












» OUTPUT BYTE 


FROM PORT 


(Z-80 VERSION) 








f FORMAT is: 


Of PORT? BYTE 


\Jt?H / 




He. 


OPORTJ 


CALL 


READHL 


pPORT 










LD 


Cf L 




5B4B 


CD 


59AE 




CALL 


READHL 


f DATA 




ED 


69 




OUT 


<C) jL 


50UTPUT 


5B50 


C9 






RET 












5 HEXADECIMAL 


MATH* SUM 


AND DIFFERENCE 


5B51 


CD 


59A3 


y 

hmath: 


CALL 


HHLDE 


pTwo numbers 










PUSH 


HL 


fSAVE HfL 


5B55 


19 






ADD 


HLfDE 


rSUM 


5B56 


CD 


59EB 




CALL 


OUTHL 


SPRINT IT 


\Ji?U 7 








POP 


HL 






R7 






OR 


A 


? CLEAR CARRY 


5£i5B 


ED 






SBC 


HL » DE 




\J JP vj i,' 




■SVFR 

7 C 13 




JP 


OUTHL 


f DIFFERENCE 








f MEMORY TEST 


THAT DOESN'T ALTER CURRENT 








J INPUT 


RANGE 


OF ADDRESSESr ABORT WITH "> 


5B60 


CD 


5999 


5 

JUST J 


CALL 


RDHLDE 


p RANGE 


5B63 


E5 






PUSH 


HL 


5 SAVE START ADDR 


5B64 


7E 




JUST2; 


LD 


A» (HL) 


f GET BYTE 


5B65 


2F 






CPL 




^COMPLEMENT IT 


5B66 


77 






LD 


(HL) rA 


fPUT IT BACK 


5B67 


BE 






CP 


(HL) 


5DID IT GO? 


5B68 


C2 


5B7E 




JP 


NZf JERR 


5 NO 


SB6B 


2F 






CPL 




50RIGINAL BYTE 


5B6C 


77 






LD 


(HL) pA 


5PUT IT BACK 
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5B6D 


7D 




JUST3; 


LD 


A»L 


J PASS 


5B6E 


93 






SUB 


E 




5B6F 


7C 






LD 


A;H 




5B70 


9A 






SBC 


AfD 




5B71 


23 






INC 


HL 




5B72 


38 


FO 




jr 


Cf JU8T2 


$N0 








f 

f AFTER 


EACH 


PASS? 










; SEE IF ABORT WANTED 




5B74 


CD 


5827 




CALL 


INSTAT 


5 INPUT? 


5B77 


C4 


58 1 5 




CALL 


NZ»INPUTT 5YESf GET IT 


5B7A 


El 






POP 


HL 


; START ADDR 


5B7B 


E5 






PUSH 


HL 


5SAVE AGAIN 


5B7C 


18 


E6 




JR 


JUST2 


yNEXT PASS 








» 

} FOUND 


MEMORY ERROR p PRINT POINTER AND 








f BIT MAP J = 


GOODj 1=BAD 


BIT 


5B7E 


F5 




r 


PUSH 


AF 


f SAVE COMPLEMENT 


5B7F 


CD 


59E8 




CALL 


CRHL 


r PRINT POINTER 


5B82 


Fl 






POP 


AF 




5B83 


AE 






XOR 


<HL) 


jSET BAD BITS 




fu >J 






PUSH 


ML 




5B85 


6F 






LD 


LjA 


5BIT MAP TO L 


5B86 


CD 


5B3A 




CALL 


BITS 


; PRINT BINARY 


5B89 


El 






POP 


HL 




5B8A 


18 


El 




JR 


JUST3 


; CONTINUE 








9 REPLACE HEX 


BYTE WITH 


ANOTHER 








; FORMAT is: 


START? STOP 


> ORIG» NEW 


5B8C 


CD 


5A80 


REPL : 


CALL 


HLDEBC 


fRANGE. 1ST BYTE 


5B8F 


DA 


59E0 




JP 


Cf ERROR 


pNO 2ND 


5B92 


41 






LD 


Bf C 


pIST TO B 


5B93 


E5 






PUSH 


HL 




5B94 


CD 


59AE 




CALL 


READHL 


?2ND BYTE 


5B97 


4D 






LD 


C»L 


fINTO C 


5B98 


El 






POP 


HL 




5B99 


7E 




REPL2: 


LD 


A? (HL) 


5FETCH BYTE 


S1FI9A 


Q 






CP 


B 


5A MATCH? 


5B9B 


20 


06 




JR 


NZ?REPL3 


?N0 


*J D T JL' 


7 1 






LD 


<HL) pC 


fSUBSTITUTE 


5B9E 


79 






LD 


AjC 




5B9F 


BE 






CP 


(HL) 


5 SAME? 


5BA0 


C2 


5A4B 




JP 


NZ?ERRB 


pNOp bad 


5BA3 


CD 


5A0C 


REPL3 : 


CALL 


TSTOP 


pDONE? 


5BA6 


18 


Fl 




JR 


REPL2 










5 

f GIVE 


RANGE 


OF 1ST BLOCK AND START OF S! 


5BA8 


CD 


5A80 


verm; 


CALL 


HLDEBC 


5 3 ADDRESSES 


5BAB 


OA 




VERM2: 


LD 


A? (BC) 


jfetch byte 


5BAC 


BE 






CP 


(HL) 


?SAME AS OTHER? 


5BAD 


28 


19 




JR 


21.VERM3 


pYES 


5BAF 


E5 






PUSH 


HL 


pDIFFERENT 


5BB0 


C5 






PUSH 


BC 
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CD 


59E8 




CRHL 




5BB4 


4E 




LD 


C f < HL ) 




5BB5 


CD 


59F0 


CALL 


OUTHEX 


fPRINT IT 


5BB8 


3E 


3A 


LD 


A J ' : ' 




5BBA 


CD 


5835 


CALL 


OUTT 




5BBD 


El 




POP 


HL 


5BjC to H?L 


5BBE 


CD 


59EB 


CALL 


OUTHL 


J SECOND POINTER 


5BC1 


4E 




LD 


Cf (HL) 


f2ND BYTE 


5BC2 


CD 


S9F8 


CALL 


OUTHX 


5PRINT IT 


5BC5 


4D 




LD 


CfL 


; RESTORE C 


5BC6 


44 




LD 


BfH 


(AND B 


5BC7 


El 




POP 


HL 


;AND HfL 


5BC8 


CD 


5A0C 


UERH3J CALL 


TSTOP 


f DONE? 


5BCB 


03 




INC 


BC 


5 2ND POINTER 


5BCC 


18 


DD 


JR 


VERH2 





END START 



Symbols J 



ADMP2 


5B01 


ADHP3 


5B18 


ADMP4 


5E1B 


ADUMP 


SAFE 


AL0D2 


5AE9 


APOS 


FFF7 


ASCII 


5AD3 


ASCS 


5B20 


BACKUP 


0008 


BIT2 


5B3C 


BITS 


5B3A 


CALLS 


5A15 


CDATA 


0011 


CHEKM 


5A46 


CIN 


5809 


COLD 


587E 


COUT 


5806 


CR 


OOOD 


CRHL 


59E8 


CRLF 


5935 


CSTAT 


0010 


CTRH 


0008 


CTRP 


0010 


CTRQ 


0011 


CTRS 


0013 


CTRX 


0018 


DEL 


007F 


DUMP 


595E 


DUMP2 


5961 


DUMP3 


5964 


DUMP 4 


5975 


DUMPS 


597E 


ERRB 


5A4B 


ERROR 


59E0 


ERRP 


5A4A 


FILL 


5A64 


FILL2 


5A6C 


FILL3 


5A72 


F1LL4 


5A7A 


GCHAR 


580F 


GETC4 


595C 


GETCH 


5949 


GO 


5A14 


HEXl 


5A01 


HHLDE 


59A3 


HLDEBC 


5A80 


HLDECK 


5A8E 


HMATH 


5BS1 


IBUFC 


57A5 


I BUFF 


57A6 


IBUFP 


57A3 


INLN 


580C 


INMSK 


0001 


INPL2 


5902 


INPL3 


591B 


INPLB 


593F 


INPLC 


5929 


INPLE 


5924 


INPLI 


590A 


INPLN 


58FD 


INPUT2 


581A 


INPUTT 


5815 


INSTAT 


5827 


IPORT 


5B31 


JERR 


5B7E 


JUST 


5B60 


JUST2 


5B64 


JUST3 


5B6D 


LDATA 


0013 


LF 


OOOA 


LOAD 


5A19 


L0AD2 


5A1C 


L0AD3 


5A3D 


L0AD4 


5A3A 


L0AD6 


5A40 


LOMSK 


0002 


LOUT 


585B 


LSTAT 


0012 


MOVDN 


5A9A 


MOVE 


5A97 


MOVIN 


5AA3 


MSIZE 


58A5 


NIB 


59D0 


NNULS 


0004 


NPAGE 


589A 


OMSK 


0002 


OPORT 


5B47 


ORG IN 


5800 


0UT2 


583C 


0UT3 


5848 


0UT4 


5851 


OUTCR 


5874 


0UTCR2 


5876 


OUTH 


5812 


OUTHEX 


59F0 


OUTHL 


59EB 


OUTHX 


59F8 


OUTLL 


59EF 


OUTSP 


59F3 


OUTT 


5835 


PASC2 


5994 


PASC3 


5996 


PASCI 


598B 


PORTN 


57A0 


RDHL2 


59B3 


RDHL4 


59C5 


RDHL5 


59CD 


RDHLD2 


599C 


RDHLDE 


5999 


READHL 


59AE 


REGS 


5A56 


REPL 


5B8C 


REPL2 


5B99 


REPL3 


5BA3 


RESTRT 


5803 


SEAR2 


5AB0 


SEAR3 


5ABA 


SEAR4 


5ACE 


SEARS 


5AC8 


SEARCH 


5AAD 


SETLST 


582C 


STACK 


57A0 


START 


5800 


TAB 


0009 


TABLE 


58C9 


TOP 


0018 


TSTOP 


5A0C 


VERM 


5BA8 


VERM2 


5BAB 


VERM3 


5BC8 


UARM 


5891 


ZERO 


5A5D 
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CONVERSION OF THE MONITOR TO Z-80 MNEMONICS 

If you used 8080 mnemonics to program the monitor in Chapter 6, you can 
now convert it to Z-80 mnemonics. The form of the mnemonics depends on 
the type of assembler you have. The Microsoft assembler accepts both the 
Intel 8080 and the Zilog Z-80 mnemonics. Since most other assemblers use 
only one or the other, you may need a second assembler. 

The Digital Research assembler MAC requires the 8080 mnemonics, but 
it can generate Z-80 code with an accompanying macro library. The Xitan 
assembler utilizes 8080 mnemonics for the common set of 8080-type instruc- 
tions and Zilog-like instructions for the others. 

First, make a working copy of the monitor using PIP, a CP/M utility 
routine. 

PIP HONZ.ASM=MON17.ASMCV3 

If you are using MAC or the Xitan assembler, skip to the next section. Other- 
wise, use the system editor to make the necessary changes to the new file. 
The conversion can be easily performed with the global substitute command 
of the Word-Master or the CP/M editor. For example, the 8080 mnemonic 

MOM AjH 

can be changed to the equivalent Z-80 mnemonic 

LD Ap(HL) 
with the command 

*SM0V<t3b>A f M*LD<tab>A f (HL) ♦OTT 

The $ symbols indicate that the escape key is pressed. The "tab" refers to 
the ASCII tab key, a control-I. You may find the cross-reference list for 8080 
and Z-80 mnemonics, given in Appendix G, helpful in the conversion process. 

After changing the monitor to Z-80 mnemonics, assemble it and care- 
fully check the assembly listing to see that the hex code is correct. The Z-80 
version at this time should generate the same hex code as the 8080 version. 
A further check can be made with the monitor's V command. Load the 
binary code into memory with an offset. A command of 

DDT 

IMONZ.HEX 

RFOOO 

will load the new version 4K bytes below the regular monitor position. 
Branch to the monitor prepared in the last chapter. Then compare its code 
to the new version using the verify command. If there is a discrepancy, find 
the error and correct it. When you are convinced that the Z-80 version pro- 
duces the same code as the 8080 version, you can begin the alterations to 
reduce the monitor's size. 
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REDUCING THE MONITOR SIZE 



In this section you will reduce the monitor size by converting many of the 
3-byte absolute jump instructions into 2-byte relative jump instructions. 
This change will make room for additional features. There are five types of 
jumps to be changed. 



absolute relative condition 

Jump Jump 

JP X JR X unconditional 

JP ZfX JR 2»X zero 

JP NZfX JR NZf X not zero 

JP CfX JR CkX carry 

JP NCf X JR NCfX not carry 



Not all of the absolute jumps can be converted in this way since the relative 
jumps are limited to a distance of about 126 bytes. 

Another way to obtain more space is to move some of the subroutines 
to more advantageous locations. This will allow a few more absolute jumps 
to be converted into relative jumps. For example, several routines contain a 
jump to the routine ERROR. These can be placed together in a group. Then 
the ERROR routine can be moved into the middle of the group. 

Another change will free up three more bytes. Notice that subroutine 
OUTSP ends with the instruction 



JP OUTT 



If this subroutine were located directly ahead of subroutine OUTT, then the 
jump instruction would not be necessary. Actually, this type of change has 
already been used extensively in our monitor. Subroutines CRHL, OUTHL, 
OUTHEX, and OUTSP are all directly related. They initially could have been 
programmed (using Z-80 mnemonics) as 



CRHL! 



CALL 
CALL 
RET 



CRLF 
OUTHL 



OUTHL : 



OUTLLS 



LD 

CALL 
LD 
CALL 
RET 



C»H 
OUTHX 

CpL 

OUTHEX 



OUTHEX t CALL 
CALL 
RET 

i 

OUTSPI LD 

CALL 
RET 



OUTHX 
OUTSP 



A» ' ' 
OUTT 
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The CALL/RET combination at tlie end of each routine can be replaced by 
a JP instruction. Then, since the calHng program is located directly above 
the called program, the jump instruction becomes unnecessary. Thus, four 
bytes are saved in each of the first three routines. Furthermore, if this entire 
block of four subroutines were located just prior to subroutine OUTT, we 
could eliminate the final JP OUTT instruction and save three more bytes. 

While this kind of subroutine rearrangement can be used to make the 
overall program smaller, there is a penalty. The readability is reduced. We 
have traded comprehension for space. This may not, in general, be a worth- 
while tradeoff for assembly-language programming. Such programs are more 
difficult to understand than those written in a high-level language such as 
Pascal or BASIC. Furthermore, assembly-language programs are typically 
much shorter than they would be if written in a higher-level language. But if 
packing a maximum number of features into a IK PROM is your goal, then 
this technique may be worth it. 



which generate four bytes of code appear in two places. Replace them with 
the 2-byte instruction 

DJNZ X 

One location is just prior to the label MSIZE (address 58A5 in Listing 7.1) 
and the other is in subroutine BITS (5B3A). This change will free four 
more bytes. 

The 16-bit subtraction routine in HMATH (5B51) has been improved. 
The sequence of instructions 

LD ArL 

SUB AfE 

LD L»A 

LD ArH 

SBC AfD 

LD Hf A 

is replaced by the shorter, double-precision subtraction: 

OR A Preset csrra 

SBC HL»DE f subtract 



GETTING MORE FREE SPACE 



The two instructions 



DEC 
JP 



B 

N2»X 



Three more bytes are freed by this change. 
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Since the Z-80 contains a set of instructions for direct rotation of data 
in the general CPU registers, we can simplify subroutine BITS. In the 8080 
version, the three instructions 

HOV A»L 
ADD A 
MOV LfA 

are used to move the data from a general register to the accumulator, perform 
the shift, then move it back. The 2-byte, Z-80 arithmetic shift left instruction 

SLA L 

performs the shift directly in the L register. 

The 8080 can output a byte only from the accumulator, and can input 
a byte only to the accumulator. Furthermore, the address of the peripheral 
must be located in memory immediately following the first byte of the input 
or output instruction. 

The port-input routine IPORT and the port-output routine OPORT in 
the system monitor utilized subroutine PUTIO. This routine writes the 
desired IN or OUT instruction in memory, the requested port address and 
then a return instruction. There is a Z-80 instruction that can perform I/O 
from any register. The address of the peripheral is located in register C in 
this case. Since the port address does not have to be located in merhory, 
subroutine PUTIO can be eliminated. The resulting Z-80 code is 19 bytes 
shorter than the 8080 version. See Listing 7.1 for the new versions of IPORT 
(5B31) and OPORT (5B47). 

Since you are nearly finished with the development of the monitor 
program, you can gain some more space by removing the routines that print 
the version number. There are four areas involved. First, delete the line near 
the beginning that identifies the version number. 

VERS EQU '17' 

Second, remove four lines starting with the label SIGNON. Third, delete the 
two lines starting on the line after the label COLD. 

LD DE> SIGNON 

CALL SENDM 

Fourth, remove the entire subroutine SENDM, but keep a copy of it in case 
you want to incorporate it in another program. 



PERIPHERAL PORT INITIALIZATION 

There are two schools of thought on peripheral port initialization. One 
approach is to initialize ports only on a cold start or a warm start. The other 
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way is to initialize a port each time it is used. The method you use depends 
on the integrity of your system. 

The approach taken in this chapter initializes ports only on a cold start. 
The instructions are placed just after the label COLD. In anticipation of 
adding a printer-output routine, we include the initialization for two sepa- 
rate peripherals. 

Ports which need initialization utilize a control register for this pur- 
pose. The address of the control register is the same as the status register. A 
CPU IN instruction reads the status register, while a CPU OUT instruction 
to the same address writes into the control register. A typical initialization 
procedure requires two OUT instructions. The first is used to reset the port; 
the second is used to set the desired options. The values shown in the listing 
correspond to a Motorola 6850 ACTA serial port set for eight data bits, one 
stop bit, and no interrupts. 

LD Af3 

OUT (CSTAT) rA i RESET 

LD A1.15H 

OUT (CSTAT) »A } SET FEATURES 



PRINTER OUTPUT ROUTINES 

Up to this point, we have been writing programs for output to a console 
video screen. We output an ASCII backspace character for error correction so 
that the cursor will actually back up on the screen. We also included a pair 
of scroll commands: control-S to freeze the display and control-Q to resume 
the scrolling. 

Sometimes, however, we want computer output we can look at after 
the computer has been shut off. A printer or list device is what we need for 
this purpose. We will not want to use the printer as a niain console, though, 
because it is too slow. 

For sophisticated operating systems like CP/M, the software for the list 
device is wholly separate. For example, we can divert a disk file to the printer 
and none of the system commands will appear on the hsting. 

Our approach will be a little different. The video console will always 
display all output whether the printer is on or not. Of course, when the 
printer is engaged, the console speed will be reduced to that of the printer. 
We will both enable and disable the printer with a control-P command, just 
as in CP/M. We refer to the control-P command as a list toggle: the same 
command turns it on or off. The output includes the echoing of the com- 
mands typed in from the console keyboard. 

Both the input and output routines will have to be changed if you want 
to incorporate the printer routines. In addition, two new subroutines will 
be added. First, add two new lines to the input routine; they will look for a 
control-P from the console keyboard. If a control-P is found, the program 



148 8080/Z-80 ASSEMBLY LANGUAGE 



will branch to a new subroutine called SETLST. The two new lines appear in 
subroutine INPUTT (5815). 

CP CTRP MP 

JR Z»SETLST JLIST 

Subroutine SETLST (582C), containing 4 lines of code, is added just 
after subroutine INSTAT. 

SETLST: LD Af (PORTN) $ CHECK FLAG 

CPL 5 INVERT 

LD (PORTN) f A J SAVE 

JR INPUTT fNEXT BYTE 

This routine complements the printer flag (PORTN) when a control-P is 
typed. The output routine uses this flag to determine whether to send out- 
put to the printer. Notice that in Chapter 6, the identifier PORTN was used 
to set up the port number for the I and O commands. This feature is not 
needed for the Z-80 version, so we can use the location for the printer flag 
instead. 

The third new section is placed in the output routine OUTT (5835). 

LD A> (PORTN) 5 WHERE? 

OR A rZERO? 

JR NZfLOUT HIST OUTPUT 

This part checks the flag PORTN to see if output is to be sent to the printer. 

The fourth routine is LOUT (585B); it follows OUT4. This routine 
sends output to both the console and the printer. It first checks the status 
port for the printer. When the output bit indicates ready, a byte is sent to 
the printer. Since the console video screen operates so much faster than the 
printer, there is no need to check the console-ready flag. The byte is there- 
fore also sent directly to the console by the next instruction. The output 
appears simultaneously at both devices. 



DELAY AFTER A CARRIAGE RETURN 

Video screens operate with electron beams that move very fast. Mechanical 
printers, on the other hand, are much slower. For some printers, the time it 
takes to execute a carriage return is so great that the first few characters of 
the next line may be lost. The solution is to have the computer do something 
else for a little while after it sends a carriage return. 

One method of slowing down the computer is to arrange for it to send 
binary zeros, called nulls, after each carriage return or carriage-return /line- 
feed pair. One routine for accomplishing this is as follows. 
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CRLF .* 



LD 



Af CR 
OUTT 

A>LF 
OUTT 



^CARRIAGE RET 
)SEND 

JLINE FEED 

I SEND 

?GET A MULL 
?SEND ^ IT 
?A SECOND ONE 
fA THIRD 
fTHE FOURTH 



CALL 
LD 



CALL 

XOR 

CALL 

CALL 

CALL 

JP 



OUTT 
OUTT 
OUTT 
OUTT 



But this approach may cause trouble if the printer circuits attempt to inter- 
pret the null characters. 

A different approach is taken with the list-output routine, LOUT, 
shown in Listing 7.1. After each carriage return is sent, the computer starts 
executing a double loop. The inner loop is executed 250 times. The outer 
loop is set according to the equivalent number of nulls that are needed. No 
nulls are actually sent, though, in this case. 

The disadvantage of this method is that the resultant delay time is a 
function of the computer speed. A Z-80 running at 4 MHz would require 
approximately twice the number of loops as would a 2-MHz Z-80. Thus, the 
loop-initialization values may have to be adjusted to the particular computer. 

Be careful to tailor the port-initialization routines to your system or 
remove them if they are not needed. The time delay in the list-output rou- 
tine should also be removed if it is not needed. If you are not sure whether 
a delay is necessary, then leave it in, at least for the first version. Then use 
the memory load command of the monitor itself to reduce the delay values 
on the two loops. When you reduce the delay time to too small a value, then 
you will notice that some of the characters are missing from the beginning of 
some of the lines. 

A sample loop-change session could look like this. 

>D5870 587F 

5870 C0D51678 1EFA1D20 1520. . . 
>L5873 

5873 >! 78 3C 

5873 . IE iX (to auit) 

The first command line is used to display the memory region containing the 
loop constants. Then the outer loop value of 78 hex is changed to 3C hex 
which is half the value. As long as you change the timing-loop values with 
the printer disengaged, no problem should occur. After each change in the 
timing loops, re-engage the printer with a control-P. Display several lines on 
the printer by giving the D command. Check to see if any of the first few 
characters of each hne are missing. If everything is all right, then again 
reduce the loop constant until characters are lost. (Be sure to disengage the 
printer between each change.) 



CHAPTER EIGHT 

Number-Base Conversion 



This chapter deals with assembly language routines that can be used to 
convert data from one form to another. The first part deals with the conver- 
sion of a sequence of ASCII characters called a string into a binary number. 
The second part reverses the procedure; binary numbers are converted into 
ASCII strings. The characters in each string represent digits in one of the 
common bases 2, 8, 10, or 16. The corresponding binary number may be 
4 bits, 8 bits, or 16 bits in size. 

All of the programs in this chapter are designed to run with the system 
monitor developed in Chapters 6 and 7. Some of the monitor's input and 
output facilities are needed. These include the console input buffer which 
supphes the characters, the binary-to-hexadecimal conversion routine which 
will print the answer in hexadecimal, and the console output routine needed 
for the error message. 

The monitor error-correction features are available during input. Press- 
ing the DEL (or RUB) key or the backspace (control-H) key will delete the 
previously typed character and remove it from the console video screen. If 
the list routines have been incorporated into the monitor, the printer can be 
turned on by typing a control-P. When you have finished with each routine, 
you can return to the monitor simply by typing a control-X. 



THE ASCII CODE 

When a key is pressed on a computer terminal, a unique signal is sent to the 
computer. There are several, very different ways of electronically encoding 
this signal. ASCII, which stands for American Standard Code for Informa- 
tion Interchange, is the most commonly used code. Appendix A gives the 
128 ASCII characters with the corresponding values expressed in decimal, 
hexadecimal, octal, and binary. EBCDIC, which is used by IBM, is another 
coding technique. 
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The ASCII table can be divided into four parts. Part 1 of the table 
contains the nonprinting control characters. Part 2 contains most of the 
special characters such as $, %, and #, and the digits 0-9. The uppercase 
letters are found in part 3, and the lowercase letters are found in part 4. 

Computer terminals typically have a keyboard that looks like a type- 
writer. There is a shift key to change from lowercase letters to uppercase 
letters. In addition to the shift key, there will usually be a control key. This 
key will give the letter keys a third meaning. Thus the user can enter a 
lowercase letter A, an uppercase letter A (a shift A), or a control-A. The bit 
patterns are: 

110 0001 lowercase A 
100 0001 uppercase A 
000 0001 control-A 

It can be seen from the pattern that the shift key resets bit 5 while the con- 
trol key resets both bits 5 and 6. 

Some of the commonly used control functions such as the carriage 
return (control-M), line feed (control-J), the horizontal tab (control-I), and 
the backspace (control-H) may have their own separate keys. 

All console input to the computer will be in the form of ASCII char- 
acters. The console will send eight data bits for each character. But the 
ASCII code contains only seven bits per character. Consequently, the eighth, 
high-order bit is not needed. The user will need to have routines for convert- 
ing strings of ASCII characters into the ultimate numbers that will reside in 
memory. For example, if the operator enters the string 

3014 

from the console, the computer would actually receive the bit patterns 

Oil 0111 (ASCIIS) 

Oil 0000 (ASCII 0) 

Oil 0001 (ASCII 1) 

Oil 0100 (ASCII 4) 

The next step is to convert the string into a 16-bit number. The conversion 
scheme that is chosen depends on whether the string represents a decimal 
number, an octal number, or a hexadecimal number. 

Additionally, a check is made to ensure that each character in the string 
is within the proper range. For example, octal numbers must contain only 
the digits zero through 7. The digits 8 and 9, the letters A through Z, and the 
other characters are not used. Finally, we may need a special character, 
called a delimiter, to indicate the end of a string. We will use a space or a 
carriage return for this purpose. Thus the string of characters 



1034 2347 



152 8080/Z-80 ASSEMBLY LANGUAGE 



will be interpreted as two separate numbers since a space appears in the 
middle. 

The ASCII string may need to be converted into a 4-bit nibble, an 8-bit 
byte destined for a CPU register, or a 16-bit word meant for a double register. 
Furthermore, the format may be either free entry or fixed entry. The choice 
is a matter of personal taste. With free entry, leading zeros are not needed. 
The entries 

0004 

004 

04 

4 

are all interpreted as the same number. An additional feature is that you can 
recover from an error by retyping the entry on the same line. Suppose that 
the 4-digit number 1035 is desired but 1045 was typed by mistake. The 
correct value can be immediately typed without a space. 

10351045 

If two 4-digit numbers are needed, they must be separated by a delimiter. 
1045 1055 

With the fixed-entry format, the required number of digits, including leading 
zeros, must be entered. But since an end-of-string indicator is not needed, 
two numbers can be run together. The fixed-entry expression 

10451055 

will be interpreted as two separate numbers. 



CONVERSION OF ASCII-ENCODED BINARY CHARACTERS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 

One of the simplest base-conversion routines is the ASCII-to-binary pro- 
gram. This program takes a string of ASCII-encoded ones and zeros from the 
console input buffer and produces an 8-bit binary number in register C. The 
hexadecimal equivalent of the number is printed on the console. If the 
operator types the string 

10101100 

the keyboard actually transmits the following sequence. 
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Oil 0001 
Oil 0000 
Oil 0001 
oil 0000 
oil 0001 
oil 0001 
oil 0000 
oil 0000 

The conversion routine will take this combination, convert it to the binary 
number 

10101100 

and place it into the C register. 

Type the routine shown in Listing 8.1 Set the assembly location some- 
where below the monitor's stack and include the address of the monitor 
using the EQU directive. The monitor I/O routines are defined relative to 
the monitor's address. 

Listing S.l» ASCI I- encoded binara to binarw in C. 

i THIS PROGRAM IS DESIGNED TO OPERATE 

t WITH THE SYSTEM MONITOR AT 5800 HEX, 
I 

f JAN 29, 80 



5000 




ORG 


5000H 






5800 




MONIT 


EQU 


5800H 




5806 




OUTT 


EQU 


MONIT+6 




580C 




INPLN 


EQU 


MONIT+OCH 


580F 




6ETCH 


EQU 


MONITJOFH 


5812 




OUTHX 


EQU 


MONIT-f 12H 


5000 


3E0n 


START! 


mi 


Af ODH 


f CARR RET 


5002 


Cn0658 




CALL 


OUTT 




5005 


3E0A 




Myi 


AfOAH 


f LINE FEED 


5007 


CD0658 




CALL 


OUTT 




500A 


CD0C58 




CALL 


INPLN 


»GET A LINE 


500D 


cniBso 




CALL 


BBIN 


SCONMERT 


5010 


CD1258 




CALL 


OUTHX 


5 HEX VALUE 


5013 


3E20 




MMI 


A? ' ' 




5015 


Cn0658 




CALL 


OUTT 





r 

f THE NEXT INSTRUCTION IS NEEDED WHEN 

5 THE ROUTINE IN LISTING 8.9 IS APPENDED 
; CALL BITS ?BIN TO ASCII 

5018 C30050 JMP START 5NEXT VALUE 

f 

} SUBROUTINE TO CONVERT UP TO 8 ASCII- 

f ENCODED BINARY CHARACTERS INTO AN 

f 8-BIT BINARY NUMBER IN C 
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ij V i. ly 








u 
II 


y O M V CL rV Cl L5 O 


1 r 


J. V 




1 VT 

A X 


Tl 9 v 


J PI FAR 


ij V X r 






UHL.L. 


Uc. 1 wri 




5022 


1IA3A50 




JC 


EIBIN3 


ILINE END 


5025 


D630 




SUI 


'0' 


f CONV TO BINARY 


5027 


DA3550 




JC 


EIBIN4 


f < 


502A 


FE02 




CPI 


2 






ri "? ri s 




INT 




f y X 


502F 






DAD 


H 


t <nHTFT 1 FFT 
yorixr 1 U.CP i 




OCT 






1 










MflU 

1 lUV 


L.. / PI 




5032 


C31F50 




JMP 


E1BIN2 


jNEXT 






f CHECK 


FOR : 


BLANK AT 1 


END 


CT /\ "7 cr 


r tr U 


f 


PC" T 




U / HNi» Ur r n 


_ - ™ 
JV^ / 


rT> "7 ri Kt A 






fc.fvKUr\ 


s w n T i:* 1 AM k' 


KT "7 A 


4 LI 




M m 1 
nU V 


L f L 


y o J. 1 a 1 U U 




111 




PHP 

r Ur 


n 


s p cr c T n P P 




u y 




r\c. 1 










? PRINT 


? ON 


IMPROPER 


INPUT 


503D 


Cl 


ERROR} 


POP 


B 


F RAISE STACK 


503E 


CI 




POP 


B 




503F 


3E3F 




MVI 


A? '?' 




5041 


CD0658 




CALL 


OUTT 




5044 


C30050 




JMP 


START 


;try again 



Assemble the program and load it into memory; start it up by branch- 
ing to the beginning of the program, the address of START. The monitor 
prompt symbol of > will appear on the console. Test the routine by entering 
the following binary numbers. Be sure to add a carriage return to the end of 
each line. 

>0 (you tape this) 

00 (prosiram responds with this) 

>1 

01 

>10 

02 (binaru 10 is hexadecimal 2) 

>11 

03 

>101 

05 (binaru 101 is hexadecimal 5) 

>1111 

OF 

>11110000 
FO 

; 10101010 
AA 

Of course, only ASCII zeros and ones are acceptable binary characters. 
Leading zeros are not necessary. If more than eight characters are entered, 
only the last eight are used. A question mark will be printed if a nonbinary 
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character is typed. Typing errors can be corrected with a backspace or 
DEL keys. 

The program consists of three parts. The first and third parts will be 
common to other conversion programs in this chapter. The first part calls 
the monitor to obtain data from the console. The last part converts the data 
to the hexadecimal equivalent and prints it on the console if valid. If the 
entry is invalid, a question mark is printed. 

The conversion routine occupies the middle portion of the program. It 
works as follows: Since HL is used as a working register, the original con- 
tents are first saved on the stack. While this step is not necessary in this case, 
it may be needed in a real application. The HL register is then zeroed. 

As each new character is obtained from the input buffer, it is converted 
from ASCII to binary by subtracting 30 hex, the value of the ASCII zero. 
An ASCII zero, which lias a value 30 hex, becomes a binary zero. Similarly, 
an ASCII 1, which has a value of 31 hex, becomes a binary 1. 



Oil 0000 ASCII zero 

Oil 0000 subtract ASCII zero 



000 0000 biriBFH zero 

Oil 0001 ASCII 1 

Oil 0000 subtract ASCII zero 



000 0001 binary 1 



A check is made at this point to ensure that an invalid character has not 
been typed. Only three characters are acceptable: An ASCII zero, an ASCII 
1, and a space. If the carry flag is set after the subtraction of an ASCII zero, 
then the input value was neither a zero nor a 1. But it might be a space 
character. A jump is made to subroutine BBIN4 in this case. This routine 
determines whether the current character is a space or some other character. 
A space is the normal end-of-string character (delimiter); other characters 
are not. 

Each character is also checked to see that it is not greater than an 
ASCII 1. In either case, if any character in the string is found to be other 
than an ASCII zero or 1, then the subroutine is terminated with a jump to 
the error routine. At this point, the stack is raised with a POP instruction, 
and control returns to START at the top of the program. 

If the input value is a zero or 1, the procedure continues. The current 
value in the HL register is multiplied by two, the binary number base. This 
arithmetic shift left is accomplished by adding the HL register to itself with 
the double-precision add DAD H. An alternate method would be to place 
the sum in the accumulator. In this case the multiplication is performed with 
an ADD A instruction. But then the intermediate sum would have to be 
saved in another register while the new character was checked. 

The new character, which is now a binary zero or 1 in the accumulator, 
is added to the value in HL. The addition of the 8-bit accumulator to the 
16-bit HL register generally requires several steps. 
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1. Add L to A. 

2. Move sum in A to L. 

3. Increment H if carry is set. 

But in this particular case, the carry Hag will never be set. Consequently, a 
simpler method of addition can be used. The one chosen for this application 
is to perform a logical OR operation with the L register and the accumulator. 

CONVERSION OF ASCII DECIMAL CHARACTERS 
TO A BINARY NUMBER 

We frequently find it useful to input computer data in the form of decimal 
numbers. We may then need a program to convert ASCII-encoded decimal 
numbers into binary form. The program given in Listing 8.2 will perform 
this task for us. 



Listing 8<2< ASCII decinisl to binsru in HL> 

; THIS PROGRAM IS DESIGNED TO OPERATE 

5 WITH THE SYSTEM MONITOR AT 5800 HEX 
5 

5 JAN 22 f 80 



5000 




ORG 


5000H 






5800 




t 

MONIT 


EQU 


5800H 




5806 




OUTT 


EQU 


MONIT+6 




580C 




INPLN 


EQU 


MONIT-fOCH 


580F 




GETCH 


EQU 


MONIT+OFH 


5812 




OUTHX 


EQU 


M0NIT+12H 


5000 


3E0D 


? 

START! 


MMI 


A f ODH 


rCARR RET 


5002 


CD0658 




CALL 


OUTT 




5005 


3E0A 




mi 


ApOAH 


pLINE FEED 


5007 


CD0658 




. CALL 


OUTT 




500A 


CD0C58 




CALL 


INPLN 


;get a line 


500D 


CD2050 




CALL 


DBIN 


pASCII TO DEC 


5010 


AC 




MOV 


C,H 


pHIgh half 


5011 


CD 1258 




CALL 


OUTHX 




5014 


AD 




MOV 


C^L 




5015 


CD 1258 




CALL 


OUTHX 


pLow half 


5018 


3E20 




MVI 


Ap ' ' 


; SPACE 


501A 


CD0658 


? 


CALL 


OUTT 








} THE 


NEXT INSTRUCTION IS NEEDED WHEN 






f THE 


ROUTINE IN 


1 LISTING 


8.11 IS USED 






5 


CALL 


BIND 


pBIN/DECIMAL 


501 D 


C30050 




JMP 


START 


5 NEXT VALUE 






r 

} ASCII DECIMAL 


TO 16-BIT IN HfL 


5020 


D5 


F 

dbin: 


PUSH 


D 


ISAVE REGS 


5021 


210000 




LXl 


Hf 


5 CLEAR 
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5024 


CD0F58 


DBIN2 ; 


CALL 


GETCH 


r GET CHAR 


ic /v -rs 

5027 


DA4650 




JC 


DBIN3 


rLINE END 


502A 


Ii630 




SUI 


' ' 


SCONV TO BI 


502C 


DA4150 




JC 


DBIN4 


! < 


502F 


F'EOA 




CF'I 


10 




5031 


024850 




JNC 


ERROR 


J > 1 


5034 


54 




MOV 


D f H 


fCOPY HfL 


5035 


5D 




MOV 


ErL 


t INTO DfE 


5036 


29 




DAD 


H 


JTIMES 2 


5037 


29 




DAD 


H 


5TIMES 4 


5038 


19 




DAD 


D 


?TIMES 5 








ri A ri 


H 


jTIMES 10 


503A 


5F 




MOM 


E?A 


jNeu byte 


503B 


1600 




MVI 


DpO 




503D 


19 




DAD 


D 


JADD NEW BY 


503E 


C32450 




JMP 


DBIN2 


INEXT 






7 

i CHECK 


FOR 


BLANK AT END 


5041 


FEFO 




CP I 


( ' '-' 


0') AND OFFH 


5043 


C24850 




JNZ 


ERROR 


»NOT BLANK 


5046 


Dl 


riEiIN3} 


POP 


D 


? RESTORE 


5047 


C9 




RET 







PRINT ? ON IMPROPER INPUT 



5048 El 

5049 El 
504A 3E3F 
504C CD0658 
504F C30050 



error: 



POP 

POP 

MVI 

CALL 

JMP 



H 
H 

Ai. '?' 

OUTT 

START 



f RESTORE 
5 STACK 



fTRY AGAIN 



This new program uses our monitor for some of the necessary sub- 
routines, just like the ASCII binary-to-binary program given in the previous 
section. Assemble the program, load it into memory, and branch to START. 
Again, the monitor prompt symbol > will appear. Try this routine by 
entering the following decimal numbers. Remember to type a carriage 
return at the end of each line. 

>0 (you type this) 

0000 (computer response) 
>1 

0001 

>10 (decimal 10) 

OA (iSives OA hex) 

>16 

OOOF 

>64 

0100 

>1024 

0400 

>65545 

FFFF 

>65547 

0002 
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If the input consists of valid decimal characters, then the response will be 
the corresponding hexadecimal value. If an invalid character is typed, a 
question mark is printed as an error message and the program is restarted. 

Since this routine generates a 16-bit binary number, the largest possible 
value is one less than 2 to the power 16. This is equivdent to a decimal 
number of 65,545. If a larger number than this is entered, the excess over 
65,545 is lost. Thus, an input of 65547 will give a value of 0002. Remember 
that the monitor error-correction features and the control-P list toggle are 
available. 

The algorithm is similar to the one in the previous section. The HL 
register pair is initially zeroed. The incoming character is converted from 
ASCII to binary, then checked to see that it is in the range 0-9. The current 
value is multiplied by 10 (the number base) prior to adding in the new 
character. The multiphcation is accomplished vdth the double-register add 
instructions as follows. 



MOV 


D»H 


(duplicBte H in 


D> 


MOV 


EfL 


<duplic3te E in 


L) 


DAD 


H 


(double initial 


value ) 


DAD 


H 


< Quadruple it) 




DAD 


n 


< 5 times initial 


value) 


DAO 


H 


(double!" making 


10 times 



the initial value) 



The total is first duplicated in the DE register. Two double-precision DAD H 
operations multiply the original value by 4. Adding in the original value with 
the DAD D makes it 5. A final DAD H produces the desired multiplication 
by 10. 

If only an 8-bit binary number is needed, then the multiplication can 
be performed in the accumulator rather than in the HL register. This will 
free the HL register for some other use, such as a memory pointer. The 8-bit 
version is given in Listing 8.3 



Listing 8.3. ASCII decimal to binary in C 



THIS PROGRAM IS DESIGNED TO OPERATE 
WITH THE SYSTEM MONITOR AT 5800 HEX 

JAN 12f 80 



5000 




ORG 

P 


5000H 




5800 




MONIT 


EQU 


5800H 


5806 




OUTT 


EQU 


MONIT+6 


580C 




INPLN 


EQU 


MONIT+OCH 


580P 




GETCH 


EQU 


MONIT+OFH 


5812 




OUTHX 


EQU 


M0NIT+12H 


5000 


3E0D 


START! 


MVI 


AfOHH II 


5002 


CII0658 




CALL 


OUTT 


5005 


3E0A 




MVI 


ArOAH ;i 


5007 


CD0658 




CALL 


OUTT 



ICARR RET 
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500A CnOC58 
500D Cril650 
5010 CD 1258 
.5013 C30050 



CALL 
CALL 
CALL 
JMP 



INPLN 
DBIN 
OUTHX 
START 



jGET A LINE 
?riEC TO BIN 
»HEX 



CONVERT ASCI I- DECIMAL TO 8- BIT BINARY 



\J\J i. o 




I'BIN i 


MMI 


C ? 


? CLEAR C 


5018 


CII0F58 


DBIN2: 


CALL 


GETCH 


5 GET CHAR 


501B 


DB 




RC 




5LINE END 


501C 


0630 




SUI 


'0' 


5C0NV TO B 


501E 


nA3250 




JC 


DBIN4 


i < 










1 






l.> niU O O 'V J V 




JNC 


EiiRRlOR 


f > 10 




*J / 




MUD 


D ? A 


fSAVE NEW 


5027 


79 




MOV 


Af C 


5 SUM 


5028 


87 




Ann 


A 


5TIMES 2 


»J V jt. / 






MOV 


C y A 


jSAVE 




o / 




ADD 


A 


?TIMES 4 




R7 




ADD 

n JL." 


A 


; TIMES 8 


502C 


81 




ADD 


C 


JTIMES 10 


502D 


82 




ADD 


n 


; COMBINE 








MOV 


C ? A 


a SAVE IN C 


502F 


C31850 




JMP 


DBIN2 


fNEXT 






? CHECK 


FOR : 


BLANK AT 1 


END 


5032 


FEFO 


DBIN4} 


CP! 


< ' 


'0') AND OFFH 


5034 


C23850 




JNZ 


ERROR 


fNOT BLANK 


5037 


C9 




RET 










1 PRINT 


? ON 


IMPROPER 


INPUT 


5038 


Fl 


> 

error; 


POP 


PSU 


? RESTORE 


5039 


3E3F 




MVI 


Ap '?' 




503B 


CD0658 




CALL 


OUTT 




503E 


C30050 




JMP 


START 


rrRY AGAIN 


5041 






END 







CONVERSION OF ASCII HEXADECIMAL CHARACTERS 
TO A 16-BIT BINARY NUMBER IN ML 



The development of a routine to convert a string of ASCII-encoded hexa- 
decimal characters into a 16-bit binary number will now be considered. This 
is the routine most frequently used in a system monitor. In fact, this was one 
of the first routines to be incorporated into our system monitor. Somewhere 
along the way there will have to be a multiplication by 16, since this is the 
base of the hexadecimal number. The multiplication can be easily performed 
by shifting the results left by four bits. Shifting left one bit is equivalent to 
multiplying by 2. Consequently, shifting by two bits performs a multiplica- 
tion by 4. 

For the binary routine we considered first, only the characters 1 and 
zero were valid. In the decimal routine that followed, the range of valid 
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input was zero to 9. The hexadecimal routine we will now consider is com- 
plicated by the fact that both the digits 0-9 and the letters A-F are valid. 

Two separate algorithms will be considered; one produces an 8-bit 
result, the other gives a 16-bit result. The program given in Listing 8.4 is 
similar to the previous ones. It will convert a string of ASCII-encoded hex 
characters into a 16-bit binary number in the H,L register pair. The double- 
precision add, DAD H, is used four times to perform the multiplication 
by 16. 



Listing 8.4, ASCII he>! to binary in HL . 







i THIS 


PROGRAM 


IS DESIGNED TO OPERATE 






t WITH 


THE SYSl 


rEM MONITOR AT 5800 HEX 






r 

f JAN 18» SO 






5000 




y 

ORG 


5000H 






5800 




t 

MONIT 


EQU 


5800H 




5806 




OUTT 


EQU 


MONIT+6 




580C 




INPLN 


EQU 


MONIT fOCH 


580F 




GETCH 


EOU 


MONIT+OFH 


5812 




OUTHX 


EQU 


M0NITH2H 


sooo 


3E:0II 


START! 


mi 


A?ODH 


5CARR RET 


5002 


CD0658 




CALL 


OUTT 




5005 


3E0A 




MVI 


AfOAH 


5LINE FEED 


5007 


CD0658 




CALL 


OUTT 




500A 


CriOC58 




CALL 


INPLN 


PGET A LINE 


50011 


CD2150 




CALL 


READHL 


. CONVERT 


5010 


4e 




MOy 


C,H 




5011 


CII1258 




CALL 


OUTHX 


5 HIGH HALF 


5014 


411 




Moy 


Cf L 




5015 


CII12S8 




CALL 


OUTHX 


5 LOW HALF 


5018 


3E20 




MVI 


fit? ' ' 


5 SPACE 


501A 


CD0658 




CALL 


OUTT 




50in 


7C 




MOV 


Af H 


J HIGH BYTE 






r 

f THE NEXT INSTRUCTION I 


S NEEDED 






f WHEN 


LISTING 


8.10 IS APPENDED 






? 


CALL 


DECS 


;H IN DECIMAL 


501E 


C30050 




JMP 


START 


{NEXT VALUE 






i READ 


UP TO 4 


ASCII HEX 


DIGITS FROM 






5 CONSOLE AND CONCERT TO 


16-BIT 






y BINARY NUMBER 


IN HpL 




5021 


210000 


7 

READHLJ 


LXI 


H?0 


{CLEAR 


5024 


CD0F58 


RriHL2J 


CALL 


GETCH 


5 GET CHAR 


5027 


ri8 




RC 




{LINE END 


5028 


CD3E50 




CALL 


NIB 


{TO BINARY 


502B 


DA3750 




JC 


RDHL4 


{NOT HEX 


502E 


29 




DAD 


H 


{TIMES 2 


502F 


29 




DAD 


H 


{TIMES 4 


5030 


29 




DAD 


H 


{TIMES 8 


5031 


29 




DAD 


H 


{TIMES 16 
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5032 B5 

5033 6F 

5034 C32450 



5037 FEFO 
5039 CO 
503A El 
503EI C34C50 



503E 
5040 

5041 
5043 
5044 
5045 
5047 
5048 
5049 
504B 



D630 
D8 

FE17 
3F 

D8 

FEOA 

3F 

»0 

1)607 
C9 



504C 3E3F 
504E CD0658 
5051 C30050 



ORA L >NEU CHAR 

MOKI Li-A 
JMP RDHL2 ,'NEXT 

CHECK FOR BLANK AT END 



RriHt.4J 



CP I 
RN2 
POP 
JMP 



( ' 
H 

ERROR 



0') ANi:i OFFH 
IRAISE STACK 



I CONVERT ASCII CHARACTERS TO BINARY 



nib; 



SUI 

RC 

CP I 

CMC 

RC 

CP I 

CMC 

RNC 

SUI 

RET 



'0' 
'F' 

10 



J ASCI I BIAS 
5 < 
'O'+l 

5 INVERT 

5 ERROR? > F 

; INVERT 
, JNUMBER 0-9 
'9' -1 

5 LETTER A-F 



f print ? on improper input 
error: 

call outt 

hry again 



MVI 

CALL 

JMP 



A? 

OUTT 
START 



Each ASCII character is converted to binary in subroutine NIB. This 
routine subtracts an ASCII zero, then checks to see that the character is 
valid. If it was originally in the range of an ASCII zero to ASCII 9, it will 
now be converted to the binary number 0-9. If a hex character A-F was 
entered, it will be converted to binary form by the additional subtraction of 
7. Of course, nonhex characters will produce the error message of a question 
mark. 

Assemble the program, load it into memory, and start it up. Type the 
following series of hex numbers. 

>1 

0001 

>10 

0010 

>A 

OOOA 
>FFFF 
FFFF 
>12345 

2345 (only last 4 charscters used) 

As with the other programs, leading zeros are not needed. If more than four 
characters are input, only the last four are used. Return to the monitor with 
a control-X. 
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CONVERSION OF TWO ASCII HEXADECIMAL CHARACTERS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 

In the previous section, HL was used to convert hex characters into a binary 
number. But, if the HL register pair is needed as a memory pointer, then the 
accumulator can be used for this conversion. In this case, however, only an 
8-bit binary number is produced. Listing 8.5 gives this version. Since the 
routine uses a fixed format, exactly two characters must be typed. This 
means that leading zeros must be entered. 



Listina 8,5. ASCII hex to 8-bit binary C. 

f THIS PROGRAM IS DESIGNED TO OPERATE 
i WITH THE SYSTEM MONITOR AT 5800 HEX 



5000 



; JAN 22 f 80 

t 

ORG 5000H 



5800 
5806 
580C 
580F 



MONIT EQU 

OUT? EQU 

INPLN EQU 

GETCH EQU 



5800H 
MONIT+6 
MONIT+OCH 
MONIT+OFH 



? REMOVE NEXT LINE WHEN LISTING 8*12 ADDED 
?OUTHX EQU M0NIT+12H 



5000 
5002 
5005 
5007 
SOOA 
500D 
5010 
5013 



3E0D 

CD0658 

3E0A 

CD0658 

CD0C58 

CD1650 

CD4350 

C30050 



start: 



mi 

CALL 

mi 

CALL 
CALL 
CALL 
CALL 

JMP 



AfODH 
OUTT 

A?OAH 

OUTT 

INPLN 

RDHEX 

OUTHX 

START 



fCARR RET 

jLINE FEED 

fGET A LINE 
jASCII TO HEX 
»BIN TO HEX 



f CONVERT 2 ASCII-HEX CHARACTERS TO 

i AN e-BIT BINARY NUMBER IN C 



5016 


CD2450 


RDHEX 1 


CALL 


HEX2 


?LEFT CHAR 


5019 


87 




ADD 


A 


f TIMES 2 


501A 


87 




ADD 


A 


rTIMES 4 


501B 


87 




ADD 


A 


5TIMES 8 


501C 


87 




ADO 


A 


fTIMES 16 


501D 


4F 




MOV 


Cfd 


5 SAVE 


501E 


CD2450 




CALL 


HEX2 


JRIGHT CHAR 


5021 


Bl 




ORA 


C 


p COMBINE 


5022 


4F 




MOV 


Cf A 




5023 


C9 




RET 






5024 


CD0F58 


f 

HEX2I 


CALL 


GETCH 


?HEX CHAR 



i CONVERT ASCII CHARACTERS TO BINARY 
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5027 


11630 




SUI 


'0' 


SASCII BIAS 


5029 


DA3950 




JC 


ERROR 


5 < 


502C 


FE17 




CPI 




+ 1 


502E 


D23950 




JNC 


ERROR 


f ERROR? > F 


5031 


FEOA 




t/tr 1 


10 




DO J3 


D8 




or* 




?NUMBER 0-9 




uo\j / 




Ql IT 
DUX 


'A'-'9' 


-1 


DU Jo 


r tOH 




l#r 1 


10 




cr i'\ "7 o 










SLETTER A-F 






i PRINT 


? ON 


IMPROPER INPUT 


5039 


Fl 


error: 


POP 


PSW 


PRAISE STACf 


503A 


Fl 




POP 


PSW 




503B 


3E3F 




HVI 


Af '?' 




503D 


CD0658 




CALL 


OUTT 




5040 


C30050 




JMP 


START 


5 TRY AGAIN 



The multiplication by 16 is performed in the accumulator by using four 
ADD A instructions. The ADD A instruction is equivalent to an arithmetic 
shift left. Data is moved from the lower four bits to the upper four, and fills 
the lower bits with zero. 

Assemble the program shown in the listing, load it into memory, and 
try it out. Remember, for this version, exactly two hex characters must be 
entered. 

>0i 

01 

>10 

10 

>0A 

OA 

>12 

12 

If everything is all right, return to the monitor with a control-X. 



CONVERSION OF ASCII OCTAL CHARACTERS 
TO A 16-BIT BINARY NUMBER IN REGISTER HL 

We did not use octal operations in the system monitor developed in Chapter 
6, yet they can be very useful in trying to understand 8080 assembly lan- 
guage instructions. From the 8080 instruction set in Appendix D, it can be 
seen that the registers are assigned values as shown in the following table. 
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register value 

B 

1 C 

2 D 

3 E 

4 H 

5 L 

6 memory 

7 A 



Thus the register-move operations are obvious from the octal representation, 
but not from the hex or decimal form. 



octal 


hex 


decimal 


operation 


101 


41 


65 


MOV B?C 


123 


53 


83 


MOM DfE 


167 


77 


119 


MOV M»A 



WhUe octal numbers appear to be better than hexadecimal for express- 
ing the 8080 operation codes, they leave something to be desired as memory 
pointers. The problem is that 16-bit addresses must be considered as two 
8-bit bytes. But octal numbers represent groupings of three bits, and 8 is not 
evenly divisible by 3. An address of FFFF hex is equivalent to 177777 octal. 
But if this address is stored in two consecutive bytes, each byte will contain 
FF hex or 377 octal. This peculiarity of octal has given rise to the expres- 
sion "crazy octal." A value of FFFF hex is 377:377 crazy octal. 



hex octal crazy octal' 

FF 377 000:377 

FFF 7777 0175377 

7FFF 77777 1775377 

FFFF 177777 3775377 



Assemble the program, load it into memory, and try it out. The octal 
numbers input to this routine can be in the range of to 177777. Try 
various octal numbers. 



>0 

0000 

>10 

0008 

>20 

0010 

>177 

007F 

>377 

OOFF 

>400 

0100 

>123456 

A72E 

>200000 (too bia) 
0000 
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Listina 8#6 ASCII octal to binary in HL. 

; THIS PROGRAM IS DESIGNED TO OPERATE 

} WITH THE SYSTEM MONITOR AT 5800 HEX 

f 

i JAN 22? 79 

5000 ORG 5000H 

I 



5800 




MONIT 


EQU 


5800H 




5806 




OUTT 


EQU 


MONIT+6 




580C 


= 


INPLN 


EOU 


MONIT+OCH 


580F 


= 


GETCH 


EQU 


MONIT+OFH 


5812 


= 


OUTHX 


EQU 


M0NIT+12H 


5000 


3E0D 


5 

START t 


MVI 


A?ODH 


fCARR RET 


5002 


CD0658 




CALL 


OUTT 




5005 


3E0A 




MVI 


AfOAH 


jLine feed 


5007 


CD0658 




CALL 


OUTT 




500A 


CD0C58 




CALL 


INPLN 


f GET A LINE 


500D 


CD2050 




CALL 


RDOCT 


50CT TO BIN 


5010 


4C 




MOM 


CfH 


(HIGH HALF 


5011 


CD1258 




CALL 


OUTHX 


5 BIN-HEX 


5014 


4D 




MOV 


CfL 


SLOW HALF 


5015 


CD1258 




CALL 


OUTHX 


; BIN-HEX 


5018 


3E20 




MVI 


Aj ' ' 


5 SPACE 


501A 


CD0658 




CALL 


OUTT 








■f THE NEXT IN 


STRUCTION IS NEEDED WHEN 






f THE ROUTINE 


IN LISTING 


8,13 IS USED 






p 


CALL 


OUTOCT 


5BIN-0CT 


50iD 


C30050 




JMP 


START 


5 NEXT VALUE 






f 

■f INPUT 


HrL FROM CONSOLE 


5020 


D5 


RDOCTI 


PUSH 


D 


JSAVE REGS 


5021 


210000 




LXI 


Hf 


S CLEAR 


5024 


CD0F58 


0BIN2: 


CALL 


GETCH 


;get CHAR 


5027 


DA4350 




JC 


0BIN3 


jLINE END 


502A 


D630 




SUI 


'0' 


fTO BINARY 


502C 


DA3E50 




JC 


0BIN4 


? < 


502F 


FE08 




CP I 


B 




5031 


D24550 




JNC 


ERROR 


} > 8 


5034 


29 




DAD 


H 


5TIMES 2 


5035 


29 




DAD 


H 


f TIMES 4 


5036 


29 




DAD 


H 


STIMES 8 


5037 


5F 




MOV 


ErA 


;new byte 


5038 


1600 




MVI 


DpO 




503A 


19 




DAD 


D 


;ado new byte 


503B 


C32450 




JMP 


0BIN2 


?NEXT 






f 

f CHECK 


FOR BLANK AT END 


503E 


FEFO 


t 

OPIN45 


CP I 


(' '-'0' 


) AND OFFH 


5040 


C24550 




JNZ 


ERROR 


SNOT BLANK 


5043 


Dl 


0BIN3: 


POP 


D 


(RESTORE 


5044 


C9 




RET 
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i PRINT ? ON IMPROPER INPUT 



5045 El 

5046 El 

5047 3E3F 
5049 CII0A58 
504C C30050 



ERROR! 



POP 

POP 

MVI 

CALL 

JMP 



A, '?' 

OUTT 

START 



H 
H 



f TRY AGAIN 



5 RAISE STACK 



This routine will convert a string of ASCII-encoded octal characters 
into a 16-bit binary number in the HL register pair. The current value in the 
HL register pair is multiphed by 8 (the number base) by performing three 
DAD H instructions. The new byte is converted from ASCII to binary by 
subtracting an ASCII zero. It is checked at this time to ensure that it is in 
the proper octal range of to 7. The addition of the new digit to the present 
value is more complicated than it was for the binary or hex routines. The 
problem is that there can be a carry out from the low-order byte. For this 
reason, the new byte is placed into the DE register pair, then combined with 
the value in HL by using the double-precision DAD D instruction. 



CONVERSION OF THREE ASCII OCTAL CHARACTERS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 

The routine given in Listing 8.7 will convert exactly three ASCII-encoded 
octal characters into an 8-bit octal number in register C. The routine is pro- 
grammed for fixed-format input; therefore, exactly three characters must be 
given. Assemble the program, load it into memory, and start it up. Type in 
the following octal numbers, including the leading zeros. 



>000 
00 

:>oio 

08 

>020 
10 

>177 
7F 

>377 



Since the largest 8-bit number is 255 decimal or 377 octal, the first digit 
must be in the range 0-3. The remaining two digits must be in the range 0-7. 
A check is made to ensure that the characters are in the proper range. The 
first ASCII character in the input string is converted to binary by subtracting 
an ASCII zero. The result is multiplied by 8 with three ADD A instructions 
and the result is saved in the C register. The next character is converted to 
binary and added to the first with the ORA C instruction. The new sum is 
multiplied by 8 again with three ADD A instructions, then saved in the C 
register. Finally, the third character is converted to binary and added in. The 
final result is moved to the C register. 
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Listing 8.7. ASCII octal 8-bit binsra in C, 

? IF THREE DIGITS? LEFT ONE MUST BE <A 
f 

i THIS PROGRAM IS DESIGNED TO OPERATE 

5 WITH THE SYSTEM MONITOR AT 5800 HEX 







9 JAN 


22» 80 






5000 




9 

ORG 


\y \j tn 






5800 




f 

MONIT 


EOU 


5S00H 




5806 




OUTT 


EOU 


M0NIT-f6 




580C 




INPLN 


EQU 


MONIT+OCH 


580F 




GETCH 


ECtU 


MONIT+OFH 


5812 




OUTHX 


EQU 


M0NIT+12H 


5000 


3E0D 


start: 


MMI 


Af ODH 


SCARR RET 


5002 


CD0658 




CALL 


OUTT 




5005 


3E0A 




HVI 


Af OAH 


5LINE FEED 


5007 


CD0658 




CALL 


OUTT 




500A 


CD0C58 




CALL 


INPLN 


9 GET A LINE 


500D 


CD1B50 




CALL 


0CT8 


f OCT/BIN 


5010 


CD1258 




CALL 


OUTHX 


5 PRINT HEX 


5013 


3E20 




MVI 


As- ' ' 


f BLANK 


5015 


CD0658 




CALL 


OUTT 





5018 C30050 



THE NEXT INSTRUCTION IS NEEDED WHEN 
THE ROUTINE IN LISTING 8.14 IS USED 
CALL OCT ;BIN TO ASCII 

JMP START 5 NEXT VALUE 



i CONVERT ASCII-ENCODED OCTAL 
1 TO 8-BIT BINARY NUMBER IN C 



501B 


CD3550 


0CT8J 


CALL 


OCTIN 


IIST CHAR 


501E 


FE04 




CP I 


4 


j FIRST 


5020 


D24750 




JNC 


ERROR 


5 TOO LARGE 


5023 


87 




ADO 


A 


? TIMES 2 


5024 


87 




ADD 


A 


f TIMES 4 


5025 


87 




ADD 


A 


?TIMES 8 


5026 


4F 




MOV 


C»A 


7 SAVE BYTE 


5027 


CD3550 




CALL 


OCTIN 


?2ND CHAR 


502A 


Bl 




ORA 


C 


5 COMBINE 


502B 


87 




ADD 


A 


JTIMES 2 


502C 


87 




ADD 


A 


; TIMES 4 


502D 


87 




ADO 


A 


jTIMES 8 


502E 


4F 




MOV 


CfA 




502F 


CD3550 




CALL 


OCTIN 


7 3RD CHAR 


5032 


Bl 




ORA 


C 


J COMBINE 


5033 


4F 




MOV 


CrA 


fSAVE IN C 


5034 


C9 




RET 










r 

f CONVERT INPUT 


CHARACTER 0-7 TO Bl 


5035 


CD0F58 


r 

octin; 


CALL 


GETCH 




5038 


DA4650 




JC 


ERR2 


7 NO CHAR 


503B 


D630 




SUI 


'0' 


>ASCII BIA£ 


503D 


DA4A50 




JC 


ERR2 


»T00 SMALL 
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5040 FE08 
5042 D24650 
5045 C9 



5046 CI 

5047 CI 

5048 3E3F 
504A CD0658 
504D C30050 



CP I 
JNC 
RET 



8 

ERR2 



5 TOO LARGE 



PRINT ? ON IMPROPER INPUT 

f RAISE STACK 



ERR2S 
ERRORS 



POP 
POP 

mi 

CALL 
JMP 



B 
B 

A» '?' 

OUTT 

START 



JTRY AGAIN 



CONVERSION OF TWO ASCII BCD DIGITS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 

The binary coded decimal (BCD) notation was introduced in Chapter 2. This 
method of encoding is less efficient than the binary notation. It takes more 
memory space to encode numbers, and mathematical operations can be 
considerably slower. The BCD notation, however, has two advantages. One 
is that conversion from decimal to BCD is simpler than conversion from 
decimal to binary. The second advantage is freedom from round-off error. 

The conversion routine given in Listing 8.8 accepts exactly two ASCII- 
encoded decimal digits and converts them into an 8-bit BCD number in the 
C register. The routine can be repeatedly called to convert numbers with 
more than two characters. 



Listiri3 8.8, 


ASCII he;- 


! to Bcn 


in C . 






'f THIS 


PROGRAM 


IS DESIGNED TO OPERA! 






5 WITH 


THE SYSTEM MONITOR AT 5800 HE 






> 

j JAN 13» 80 




5000 




f 

ORG 


5000H 




5800 




5 

MONIT 


EOU 


5800H 


5806 




OUTT 


EQU 


MONIT+6 


580C 




INPLN 


EQU 


MONIT+OCH 


580F 




GETCH 


EQU 


MONIT+OFH 


5812 




OUTHX 


EQU 


M0NITti2H 


5000 


3E0ri 


start; 


Wl 


AfODH ?CARR RET 


5002 


CD0658 




CALL 


OUTT 


5005 


3E0A 




My I 


AfOAH n.im: feed 


5007 


Cri0658 




CALL 


OUTT 


500A 


CII0C58 




CALL 


INPLN 5 GET A LINE 


5000 


CD2050 


R DHL 2 J 


CALL 


HEX2 5 LEFT CHAR 


5010 


87 




ADD 


A J TIMES 2 


5011 


87 




ADD 


A fTIMES 4 


5012 


87 




ADD 


A 5 TIMES 8 


5013 


87 




ADD 


A 5TIMES 16 


5014 


4F 




Moy 


C?A fSAVE 
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5015 


cnaoBo 




CALL 


HEX 2 


5 RIGHT CHAR 


5018 


Bl 




ORA 


C 


5C0MBINE 


5019 


4F 




MOV 


C>A 




501A 


CD 1258 




CALL 


OUTHX 


SPRINT 


501D 


C30050 




JMP 


START 


PNEXT 


5020 


CD0F58 


f 

HEX2; 


CALL 


GETCH 


5 HEX CHAR 



5023 
5025 



11630 
DA2B50 



5028 FEOA 
502A D8 



502B 3E3F 
502D Cri0658 
5030 C30050 



f CONVERT ASCII CHARACTERS TO BINARY 



NIB! 



SUI 
JC 
CPI 
RC 



'0' 

ERROR 

10 



5ASCII BIAS 
} < 



j NUMBER 0-9 

5 PRINT ? ON IMPROPER INPUT 



error: MVI 

CALL 
JMP 



Af '?' 
OUTT 

START JTRY AGAIN 



5033 



ENB 



With the BCD notation, there is a 2:1 correspondence between the 
number of BCD digits and the necessary number of bytes. Or, put another 
way, two decimal digits are stored in each byte. This arrangement is some- 
times called packed decimal. The right decimal digit is encoded in the low- 
order four bits and the left digit is encoded into the high-order four bits. 

38 0011 1000 
27 0010 0111 
59 0101 1001 

BCD encoding involves essentially the same steps as does the hex-to-binary 
routine, except that only the characters through 9 are allowed. The bit 
patterns corresponding to the hexadecimal numbers A through F are not 
allowed. 



CONVERSION OF AN 8-BIT BINARY NUMBER IN C 
TO A STRING OF EIGHT ASCII BINARY CHARACTERS 

In the first part of this chapter we developed programs to convert strings of 
ASCII-encoded characters into binary numbers. The programs in the follow- 
ing sections will perform the reverse operation. Binary numbers will be 
converted into strings of ASCII-encoded characters. Furthermore, we will 
combine the new routines with those already developed so that they may be 
more easily tested. 

The program shown in Listing 8.9 can be used to convert an 8-bit 
binary number in register C into eight ASCII-encoded binary characters. The 
resulting characters are sent to the console in this case, but they could be 
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placed into sequential memory locations instead. This routine is incorpo- 
rated into the system monitor developed in Chapters 6 and 7. 

Listing 8.9 Binsra in C to ASCII birory. 

} THIS PROGRAM IS DESIGNED TO RUN WITH 
} THE SYSTEM MONITOR AND WITH THE 
5 PROGRAM SHOWN IN LISTING 8.1 

5 PRINT AN 8~BIT BINARY NUMBER IN C AS 
5 8 ASCII-ENCODED BITS 



504A 


0608 


bits: 


mi 


Bf 8 


58 BITS 


504C 


79 


BIT2: 


MOV 


AkC 


5 GET BYTE 


504D 


87 




ADD 


A 


5 SET CARRY 


504E 


4F 




MOV 


CrA 


5 PUT BACK 


504F 


3E18 




MMI 


A» '0'/2 


5 HALF OF 


5051 


8F 




ADC 


A 


5D0UBLE+CARRY 


5052 


CD0658 




CALL 


OUTT 


5 ONE BIT 


5055 


05 




DCR 


B 


5 COUNT 


5056 


C24C50 




JNZ 


BIT2 


58 TIMES 


5059 


C9 




RET 






505A 






END 







Make a duplicate copy of the source program shown in Listing 8.1. 
This routine was used to convert ASCII-encoded binary characters into an 
8-bit binary number in C. Remove the semicolon from the instruction that 
reads 

i CALL BITS fBIN TO ASCII 

Also delete the END directive if you used one. Add the lines given in Listing 
8.9 to the end of the program. 

The new routine works in the following way. Register B is initialized 
with the value of 8, the number of bits to be generated. Register C begins 
with the original binary byte. The bits of this byte are shifted to the left one 
at a time into the carry flag. The carry flag is then added to an ASCII zero 
to produce a or a 1 at the console. For the 8080 version, the byte is moved 
to the accumulator, shifted left with an add instruction, then returned to 
register C. 

If the current high-order bit is a zero, then the carry flag is reset and a 
zero is printed. If the current high -order bit is a 1, then the carry flag is set 
and a 1 is printed. The count in the B register is decremented after each 
character is printed. When the count reaches zero, the process is terminated. 

Notice that the addition of the carry flag to the ASCII zero could have 
been accompHshed with the instructions 

MVI A»'0' 
ACI 
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However, this will require four bytes. The code we will use, which is not so 
obvious, requires only three bytes. 

ADC A 



If you have a Z-80 CPU, this routine can be simplified and shortened 
by three bytes. Performing the rotation directly in the C register reduces 
the program by one byte. Two additional bytes are gained by using the 
decrement B, jump-not-zero operation. Now the accumulator can be zeroed 
with an exclusive-or operation and the carry can be added directly to an 
ASCII zero. 



LD 


B?8 


^8 BITS 


XOR 


A 


fZERO A 


SLA 


L 


f SHIFT L LEFT 


ADC 


A» '0' 


^ADD CARRY TO 


CALL 


OUTT 


J SEND 


nJNZ 


BIT2 


i8 TIMES 


RET 







Assemble the combined program, load it into memory, and start it up. 
Be sure that the monitor is in place at the address of MONIT. The new 
binary-to-ASCII binary routine has been added in addition to the original 
binary to ASCII hex in the system monitor (OUTHX). Consequently, each 
number will now be rendered in both hex and binary. Type in the following 
binary numbers. 



>0 (you type this) 

00 00000000 (both hex and hinara are aiven) 
>1 

01 00000001 

>101 

05 00000101 
>10101010 
AA 10101010 
Mil 10000 
FO 11110000 



Remember that the error-correction features of the monitor are available. If 
you inadvertently type a control-X, you will end up in the monitor itself. 
You can return from the monitor to the new program, however, by typing 

>G5000 

if this is where you assembled the new routine. 
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CONVERSION OF AN 8-BIT BINARY NUMBER 
INTO THREE ASCII DECIMAL CHARACTERS 

An 8-bit binary number can be converted into a string of ASCII-encoded 
decimal characters by repeated subtraction of powers of 10, the number 
base. The corresponding decimal number will lie in the range of zero to 255. 
The value of 100 (decimal) is repeatedly subtracted from the original binary 
number until the result becomes negative. One less than the number of 
subtractions is the number of hundreds in the decimal form. The result, 
which in this case can only be 0, 1, or 2, is added to the value of an ASCII 
zero, then sent to the console. 

As an example of the 100s subtraction, consider the number 137. 

137 

-100 (one subtraction) 
37 

-100 (too many) 
(negative number) 

Since there was one subtraction of 100 before the number became negative, 
the number is in the range 100 to 199. 

The value of the last 100 is added back to make the number positive 
again. Then the value of 10 is repeatedly subtracted from the new value 
until a negative result is again obtained. The number of tens in the decimal 
form is one smaller than the number of subtractions. This count is added to 
an ASCII zero and sent to the console for the middle digit. The value of ten 
is added back to the remainder. This adjusted remainder is then added to an 
ASCII zero to produce the units digit. It too is sent to the console. 

Continuing with the example: 

(negative number) 

+100 (add back last 100) 

37 

-10 (first subtraction) 
27 

-10 (2nd subtraction) 
17 

-10 (3rd subtraction) 
7 

-10 (too many) 

(negative number) 
+ 10 (add back last 10) 

7 (units) 

Since there were three subtractions of 10 before the remainder became 
negative, the middle digit is a 3. Finally, the right digit is 7, the remainder 
after the last subtraction of 10. 
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Lisiting 8.10 gives the instructions for the conversion of an 8-bit binary 
number in register H. Register D initially contains the value of 100 (decimal) 
that is to be repeatedly subtracted from the number in H. As soon as the 
result of the subtraction becomes negative, the last 100 is added back, and 
the value in D is changed to a 10 by subtraction of 90. Register C is used to 
count the number of subtractions. It is initialized with the value of one less 
than an ASCII zero to simplify the conversion. 



Listing 8.10. Binary in A to ASCII decimal. 

? THIS PROGRAM IS DESIGNED TO RUN WITH 

7 THE SYSTEM MONITOR AND WITH THE 

; PROGRAM SHOWN IN LISTING 8.4 

f 

f FEB 27 f 80 

i PRINT BINARY NUMBER IN A AS ASCII 

i DECIMAL DIGITS. LEADING ZEROS SUPPRESSED 

p 



5057 


D5 


DECS J 


PUSH 


D 




5058 


C5 




PUSH 


B 




5059 


lEOO 




MMI 


EjO 


PLEADING FLAG 


505B 


1664 




MMI 


Df 100 




505D 


0E2F 


DEC81J 


MVI 


C? 'O'-l 




505F 


OC 


DEC82: 


INR 


C 




5060 


92 




SUB 


D 


pIoo or 10 


5061 


D25F50 




JNC 


DEC82 


fSTILL + 


5064 


82 




ADD 


D 


5 ADD BACK 


5065 


47 




MOV 


B>A 


p REMAINDER 


5066 


79 




MOV 


AjC 


pGET 100/10 


5067 


FE31 




CP I 


' 1 ' 


pZERO? 


5069 


D27250 




JNC 


DEC84 


5 YES 


506C 


7B 




MOV 


Af E 


p CHECK FLAG 


506D 


B7 




ORA 


A 


PRESET? 


506E 


79 




MOV 


ApC 


p RESTORE BYTE 


506F 


CA7750 




JZ 


DEC85 


PLEADING ZERO 


5072 


CD0658 


DEC84J 


CALL 


OUTT 


ppRINT IT 


5075 


lEFF 




MVI . 


EfOFFH 


pSET FLAG 


5077 


7A 


DEC85I 


MOV 


A?D 




5078 


D65A 




SUI 


90 


5100 TO 10 


507A 


57 




MOV 


D?A 




507B 


78 




MOV 


AyB 


5 REMAINDER 


507C 


D25D50 




JNC 


DEC81 


pAGAIN 


507F 


C630 




ADI 


'0' 


pAscii bias 


5081 


CD0658 




CALL 


OUTT 




5084 


CI 




POP 


B 




5085 


ni 




POP 


D 




5086 


C9 




RET 






5087 






END 







There is an additional feature added to this routine: leading-zero sup- 
pression. Leading zeros are typically suppressed when a number is expressed 
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in decimal form. On the other hand, leading zeros are commonly left in 
place for binary, octal, and hexadecimal numbers. Thus, we write 

1 

2 
18 
197 
207 

for decimal numbers, but 

00001111 (binary) 

040 (octal) ' 
0FE3 (hexadecimal) 

for the others. 

One reason for keeping leading zeros is to make it easier to distinguish 
octal or hex numbers from decimal numbers. With this convention, the 
number 0137 would be interpreted as an octal or hex value rather than a 
decimal number. The suppression of leading zeros is not a difficult task, but 
it does require some additional code. It is not sufficient to merely remove 
all zeros, for then the number 0307 becomes 37. 

One technique is to utilize a zero-suppression flag which is initially 
reset. Zeros are omitted as long as the flag remains reset. Then the flag is set 
when the first nonzero character is encountered. Subsequent zeros are not 
removed since the flag is set. 

The necessary zero-suppression code has been included in the routine 
shown in Listing 8.10. Register E is used for the flag; it is initially reset. 
Then each character is checked with a CPI '1' instruction to see if it is an 
ASCII zero. If the value is not a zero, it is printed and the flag is set to FF 
hex. On the other hand, if the digit is a zero, the flag is checked. If it is 
found to be reset, the zero is not printed. Only three decimal characters can 
be produced from the original byte; consequently, just the first two need to 
be checked. If the value of the byte is zero, a single ASCII zero is printed. 

The B, C, D, and E registers are utilized in the operations. Conse- 
quently, the original veilues are initially saved on the stack, then restored at 
the conclusion of the routine. 

Duplicate the program shown in Listing 8.4, the ASCII-hex to binary 
routine. Keep one of the copies as a backup, then rename the other one 
HEXDEC.ASM. Remove the semicolon at the beginning of the line 

S CALL DECS 

and remove the END directive at the end of the program. Add the lines given 
in Listing 8.10. Assemble the combination program, load it into memory, 
and start it up by branching to the address of START. We have coupled the 
16-bit hex input program with the 8-bit decimal output program. Conse- 
quently, only the high-order byte will be converted to decimal. This is the 
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byte in the H register. Try the combined program with the following hex 
numbers. 

>0 

0000 

>1 

0001 
>100 
0100 1 
>A00 

OAOO 10 (hex A is decimal 10) 
>1000 

1000 16 (10 he;-! is 16 decimal) 

>FFFF 

FFFF 255 <FF hex is 255 decimal) 

This binary-to-decimal routine can be very useful at the CP/M systems 
level. Suppose that you want to save a program that starts at 100 hex and 
runs to 2736 hex. If the decimal routine is incorporated into a hexadecimal 
math routine of the system monitor, you have only to type 

>H2800 100 (command) 
2900 2700 39 (response) 

The response of 39 is the decimal number of 256-byte blocks to be saved. 
Then you can give the CP/M command 

A>SAME 39 FILENAHE.EXT 



CONVERSION OF A 16-BlT BINARY NUMBER 
INTO FIVE ASCII DECIMAL CHARACTERS 

In the previous section, we developed a routine to convert an 8-bit binary 
number into three ASCII-encoded decimal characters. We will now write a 
routine for converting a 16-bit binary number in HL into 5 ASCII-encoded 
decimal characters. This double-precision decimal number will range from 
zero to 65,535. 

Duplicate the decimal-to-1 6-bit binary program in Listing 8.2. Remove 
the semicolon from the line 

} CALL DBIN 

and the END directive if you used one. Add the program shown in Listing 
8.11 to the end. 
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Listing 8.11 Binary in HL to ASCII decimal. 

} THIS PROGRAM IS DESIGNED TO RUN WITH 

f THE SYSTEM MONITOR AND WITH THE 

i PROGRAM SHOWN IN LISTING 8.2 
> 

t FEB 22? 79 

i PRINT BINARY NUMBER IN H»L AS ASCII 

f DECIMAL DIGITS. LEADING ZERO SUPPRESSED. 

5 



5055 


0600 


BIND? 


MVI 


Bf 


PLEADING FLAG 




1 1 r Ot'o 




LXI 


D>-10000 




505A 


CD7550 




CALL 


SUBTR 


; 10 THOUS 


505D 


1118FC 




LXI 


D?-1000 




5060 


CD7550 




CALL 


SUBTR 


riHOus 


5063 


119CFF 




LXI 


Df-100 




5066 


CD7550 




CALL 


SUBTR 


? HUNDREDS 


5069 


11F6FF 




LXI 


Dj-10 




506C 


CD7550 




CALL 


SUBTR 


»TENS 


506F 


7D 




MOV 


A»L 




5070 


C630 




ADI 


'0' 


?ASCII BIAS 




O W O \J O 




JMP 


OUTT 


f UNITS 






5 SUBTRACT POWER OF TEN 




5075 


0E2F 


1 

SUBTRI 


MVI 


Cr '0'~1 


» ASCII COUNT 


5077 


OC 


SUBT2: 


INR 


C 




5078 


19 




DAD 


D 


rADD NEG NUMBER 


5079 


DA7750 




JC 


SUBT2 


jKeep going 






1 

% ONE 


TOO MANYf 


ADD ONE 


BACK 


507C 


7A 


» 


MOV 


A?D 


» COMPLEMENT 


507D 


2F 




CMA 




% DrE 


507E 


57 




MOV 


Dr A 




507F 


7B 




MOV 


A f E 




5080 


2F 




CMA 






5081 


5F 




MOV 


EjA 




5082 


13 




INX 


D 


pAND 


5083 


19 




DAD 


D 


5 ADD BACK 


5084 


79 




MOV 


A»C 


J GET COUNT 






5 CHECK FOR ZERO 




5085 


FE31 




CP I 


' 1 ' 


pLESs than 1? 


5087 


D29150 




JNC 


NZERO 


%m 


508A 


78 




MOV 


A^B 


J CHECK FLAG 


508B 


B7 




ORA 


A 


5 set? 


508C 


79 




MOV 


AjC 


» RESTORE 


508D 


C8 




RZ 




jSKIP LEADING 


508E 


C30658 


% 


JMP 


OUTT 


p INTERIOR ZERO 






% SET 


FLAG FOR 


NON-ZERO 


CHARACTER 


5091 


06FF 


f 

NZERO! 


MVI 


BpOFFH 


?SET FLAG 


5093 


C30658 




JMP 


OUTT 


J PRINT IT 


5096 




5 


END 
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This 16-bit version is similar to the 8-bit version of the previous section. 
This time we start with the subtraction of the decimal value 10,000 instead 
of 100. The number of subtractions is counted as before. When the result 
becomes negative, the last 10,000 is added back. The number of subtractions 
that was performed is the desired digit for the ten-thousandths position. 

Since the 8080 CPU does not incorporate a 16-bit subtraction operation, 
the subtraction is obtained by adding the corresponding two's complement 

LXI Df~10000 

6 4* 

♦ ♦ » 

DAD n 

The carry flag will be set for each addition (subtraction) except the last. The 
carry flag is then reset for the operation corresponding to the result becom- 
ing negative. The JC instruction in subroutine SUBTR causes the computer 
to loop the correct number of times. Suppose, for example, that the binary 
number in HL corresponds to the decimal number 32,128. This is the 
equivalent of the hexadecimal value 7D80. The two's complement of 10,000 
is D8F0 hex. The sum of these two is 



decimal hexadecimal 

32 s. 128 7D80 

-ICOOO -tnSFO 

22^128 5670 



Thus the addition of 7D80 and D8F0 hex is equivalent to subtracting 
10,000 from 32,128. 

The last subtraction that causes the result to become negative has to be 
undone. This could be accomplished by adding 10,000. However, the addi- 
tion is accomplished in subroutine SUBTR which is also used to add back 
the 1,000, 100, and 10 for the equivalent steps of each decade. Therefore, 
we won't know, in general, which value to add. The solution is to obtain the 
necessary value from the two's complement of the two's complement for 
the current value. This two's complement is first obtained by complementing 
both the D and the E register to produce the one's complement. Then the 
DE register pair is incremented. Subroutine SUBTR is first called with DE 
set to -10,000, then to -1,000, -100, and -10. At this point, the units digit 
is contained in the L register. 

This double-precision routine also incorporates instructions for sup- 
pressing leading zeros. The approach is similar to the one used in the previous 
section except that the H register is used for the zero flag. 

Assemble the combination program, load it into memory, and start it 
up. Enter the following decimal numbers. The response will include both the 
hexadecimal and the decimal values of the input number. 
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>0 

0000 

:>i 

0001 1 

>ioo 

0064 100 

>1024 
0400 1024 
>65535 
FFFF 65535 

At this point you may want to incorporate decimal numbers into the system 
monitor. When we incorporated an ASCII-input feature into the monitor we 
used the apostrophe to indicate this fact. It is customary to precede decimal 
numbers by a number sign. For example, the following input would indicate 
decimal input. 

>H#1024 #200 



CONVERSION OF AN 8-BIT BINARY NUMBER 
INTO TWO ASCII HEXADECIMAL CHARACTERS 

The conversion of an 8-bit binary byte into two ASCII-encoded hexadecimal 
characters is an interesting exercise. The high-order four bits are represented 
by one hex character, and the low-order four bits are represented by the 
other hex character. Since the upper character is printed first, the upper four 
bits are rotated down to the lower position. These new lower four bits are 
converted to ASCII to produce the first character. Then the original low- 
order four bits are converted to ASCII to get the second character. 

The nibble conversion appears to be straightforward. The upper four 
bits are zeroed by performing a masking AND with the value of OF hex. The 
lower four bits are then converted to ASCII by the addition of an ASCII 0. 
If the result is in the range 0-9, then the conversion is complete. Otherwise, 
a binary 7 is added to the result, converting it to an ASCII-encoded letter of 
A through F. 

To see why this conversion works, look at the ASCII table in Appendix 
A. The ASCII number 9 has a decimal value of 57. The ASCII letter A has a 
decimal value of 65. But the hexadecimal value of A follows the value of 9. 
Therefore, we need to add 7 to any valid hex number larger than 9 to con- 
vert it into the appropriate ASCII letter A through F. 

The program shown in Listing 8.12 will convert an 8-bit binary number 
in the C register into two ASCII characters and send them to the console. 
Duplicate the program in Listing 8.5. Remove the external reference to 
subroutine OUTHX near the beginning. 

OUTHX EQU M0NIT+12H 

Our new program will perform the same function. Also remove the final 
END directive if you used one. Copy the lines from Listing 8.12 on the end 
of the program. Assemble the combined program, load it into memory, and 
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Start it up. Our monitor will still have to be in memory since we will need 
the I/O routines. This current version, Listing 8.12, with the built-in binary- 
to-hex routine, should respond exactly the same as the earlier version, 
Listmg 8.5. The only difference is that we are converting binary to hex 
withm the program rather than using a routine in the monitor. 

Listina 8*12 Binary in C to ASCII hex 

'f THIS PROGRAM IS DESIGNED TO RUN WITH 

5 THE SYSTEM MONITOR AND WITH THE 

f PROGRAM SHOWN IN LISTING 8.5 
5 

> JAN 18 » 80 
f 

■f ROUTINE TO OUTPUT 2 HEX CHARACTERS FROM C 

f 3-BIT BINARY TO ASCII HEX CONVERSION 



5043 79 

5044 IF 

5045 IF 

5046 IF 

5047 IF 

5048 CD4C50 
504B 79 

504C E60F 
504E C630 
5050 FE3A 
5052 DA0658 
5055 C607 
5057 C30A58 

505A 



OUTHXJ 



HEXl 



MOV 

RAR 

RAR 

RAR 

RAR 

CALL 

MOV 

ANI 

ADI 

CP I 

JC 

ADI 

JMP 

END 



A»C 



HEXl 
ApC 

OFH 
'0' 
'9'H 
OUTT 

7 

OUTT 



?6ET BYTE 
f ROTATE 
! FOUR 
f BITS TO 
? THE RIGHT 
5 UPPER CHAR 
f LOWER CHAR 

fLOW 4 BITS 
5ASCII ZERO 
iO TO 9 
5 YES 

5 CONVERT 
5A TO F 



The algorithm used to convert the binary nibble to a hex character 
clearly demonstrates the technique. But there is a more efficient method for 
CPUs such as the 8080 and Z-80 that incorporate the decimal adjust accum- 
ulator (DAA) instruction. Change the second, third, fourth, and fifth lines 
of subroutine HEXl so the subroutine looks like 



HEXi: 



ANI 


OFH 


( S3i»e) 


ADI 


90H 


( new ) 


DAA 




(new) 


ACI 


40H 


(new ) 


DAA 




( new ) 


JMP 


OUTT 


(same) 



Conversion of a 16-bit binary value into four hex characters is obtained 
by calling the 8-bit routine twice. For example, the HL register pair can be 
printed with the following routine. 



outhl: 



MOV 
CALL 
MOV 
CALL 



CfH 
OUTHX 

CfL 
OUTHX 
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Conversion of a binary number to a string of ASCII-encoded BCD 
characters does not require a special routine. It is performed simply by 
calling the binary-to-hex routine OUTHX. 

CONVERSION OF A 16-BIT BINARY NUMBER 
INTO SIX ASCII OCTAL CHARACTERS 

A 16-bit binary number in the HL register pair can be converted into six 
ASCII-encoded octal characters by repeatedly shifting the double register to 
the left. We make use of the double-register add instruction DAD H. This 
instruction adds the register pair HL to itself. The operation is equivalent to 
a double-precision arithmetic shift left. All 16 bits are shifted left and a zero 
is moved into the lowest order bit. The carry flag is set if the original highest- 
order bit was a logical one. The carry bit is reset otherwise. 

The routine is shown in Listing 8.13. As the bits of the double register 
are shifted out the high end, they are converted to the corresponding octal 
number in the accumulator. The largest 16-bit octal number is 177777; 
consequently, the first octal character (starting from the left) can only be a 
zero or a one. The remaining five characters can range from zero through 7. 
They are obtained from groups of three bits. 

Listing 8.13 Binary in HL to ASCII octal , 

; THIS PROGRAM IS DESIGNED TO RUN WITH 
; THE SYSTEM MONITOR AND WITH THE 

> PROGRAM SHOWN IN LISTING 8.6 

I 

> JAN IBf 80 







} ROUTINE TO 


OUTPUT A 16 


-BIT BINARY 






f VALUE 


IN Hf 


L AS OCTAL 


CHARACTERS 


5052 


E5 


p 

outoct: 


PUSH 


H 


?SAVE VALUE 


5053 


C5 




PUSH 


B 




5054 


0605 




mi 


Bf5 


5 5 CHAR 


5056 


AF 




XRA 


A 


f ZERO 


5057 


29 




DAD 


H 


SHIGH BIT 


5058 


CE30 




ACI 


'0' 


; ADDED IN 


505A 


CD0658 




C/ ^L. I- 


OUTT 


f PRINT IT 


505D 


3E06 


0CT2J 


mi 


A f 6 


1 ROTATE 60Q 


505F 


29 




DAD 


H 


; CARRY 


5060 


17 




RAL 




5 ROTATE TO A- 


5061 


29 




DAD 


H 


f AGAIN 


5062 


17 




RAL 




fTO A 


5063 


29 




DAD 


H 


5 3RD TIME 


5064 


17 




RAL 




fTO A 


5065 


CD0658 




CALL 


OUTT 


» PR I NT CHAR 


5068 


05 




ncR 


B 


fCOUNT 


5069 


C25D50 




JNZ 


0CT2 


p5 TIMES 


506C 


CI 




POP 


B 




506D 


El 




POP 


H 




506E 


C9 




RET 






506F 




} 


END 
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The first step shown in Listing 8.13 saves the HL and BC registers on 
the stack. This operation may not always be necessary. The XRA operation 
is used to zero the accumulator. It must be performed before the DAD H 
instruction since it resets the carry flag. The DAD instruction will set the 
carry flag if the high-order bit was a 1, or reset the flag if the high-order bit 
was a zero. The carry flag is then added to an ASCII zero and sent to the 
console. 

The remaining five digits are generated in a loop starting at label 0CT2. 
Register B is preloaded with the value of 5 to count the remaining digits. 
We need to transfer the current three high-order bits from the H register into 
the accumulator. This is accomplished by three DAD H instructions. After 
each one, the carry flag will reflect the state of the most recent high-order 
bit of H. After each DAD instruction, we perform a rotate accumulator 
instruction. This moves the carry bit into the low-order bit of A. After three 
such operations, the three low-order bits of the accumulator will contain 
the proper octal bit pattern for the appropriate character. But they are in 
binary form and we need to convert them to ASCII for printing. 

The bit pattern for the ASCII zero is Oil 0000. Notice that it contains 
zeros in the lower four bit positions. At the beginning of the 0CT2 loop we 
preloaded the accumulator with a binary 6 which has a bit pattern of 
000 0110. At the conclusion of the 0CT2 loop, the three rotations will 
convert this binary 6 into a 60 octal which is equivalent to an ASCII zero. 
This effectively converts the three lower-order bits, shifted in from the carry 
flag, into ASCII-encoded octal. 

The Z-80 version can be a little shorter if the instruction 

DJNZ 0CT2 
is used in place of 
ncR B 

JNZ 0CT2 



CONVERSION OF AN 8-BIT BINARY NUMBER 
INTO THREE ASCII OCTAL CHARACTERS 

In the previous section we derived a subroutine for the conversion of a 16-bit 
binary number into ASCII characters. The conversion of an 8-bit binary 
number to octal will be considered here. We could use the H,L double 
register, as previously, to perform the necessary shifts. However, if the H,L 
register is needed for something else, such as a pointer to memory, then 
another method would be better. 

The routine shown in Listing 8.14 performs the needed rotations in the 
accumulator. The original binary byte is in the C register. The byte is moved 
to the accumulator and two left circular rotate instructions are performed. 
This effectively moves the two high-order bits down to the two low-order 
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positions. It is equivalent to performing six right circular rotations. The 
remaining bits are zeroed with a logical AND 3 step. The ubiquitous ASCII 
zero is added, and the result is sent to the console. 

The middle character is obtained by rotating the original byte to the 
right. A logical AND 7 isolates these low-order bits. The ASCII zero is added 
and the byte is sent to the console. The original byte is retrieved a third 
time. Now the three bits of the third character are properiy positioned. 
Hence no rotation is needed. The masking AND operation is still needed, 
however. Finally, the ASCII zero is added prior to printing. 

Type the program shown in Listing 8.14. Add the new program to the 
end of the octal-to-binary program shown in Listing 8.7. Assemble the com- 
bination, load it into memory, and branch to the beginning. Remember that 
the input requires exactly three octal characters. If less than three are used, 
an error message of a question mark will be printed. If more than three 
characters are typed, only the first three will be used. 

Listing 8.14. 8-bit binary in C to ASCII 

( THIS PROGRAM IS DESIGNED TO RUN WITH 
5 THE SYSTEM MONITOR AND WITH THE 
; PROGRAM SHOWN IN LISTING 8.7 

5 JAN 22 f 80 

ROUTINE TO OUTPUT AN 8-BIT BINARY 
} VALUE AS THREE OCTAL CHARACTERS 



5053 


79 


OCT; 


MOM 


A»C 


>QET IT 


5054 


07 




RLC 




52 HIGH BITS 


5055 


07 




RLC 






5056 


E603 




ANI 


3 


jMASK 


5058 


CD6550 




CALL 


0CT3 




505B 


79 




MOV 


AfC 


5GET AGAIN 


505C 


OF 




RRC 




fMIDDLE BITS 


S05D 


OF 




RRC 






505E 


OF 




RRC 






505F 


CD6350 




CALL 


0CT2 




5062 


79 




MOM 


AfC 


JRIGHT BITS 


5063 


E607 


0CT2J 


ANI 


7 


5 3 BITS 


5065 


C630 


0CT3; 


AD I 


'0' 


$ASCII BIAS 


5067 


C30658 




JMP 


OUTT 


f PRINT 


506A 




9 


END 







CONVERSION OF A 16-BlT BINARY NUMBER TO SPLIT OCTAL 

Some of the 8080 and Z-80 instructions can have either 8-bit or 16-bit 
operands. Typical 8-bit operations for the 8080 are 

MVI A»10 
ADI 3 
ANI 7 
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The 16-bit operations include 



CALL 

JMP 

LXI 



lOOH 

5005H 

HfO 



But the 8-bit architecture of microcomputers means that 16-bit operands are 
stored as two consecutive bytes. Each byte can be represented as two hexa- 
decimal characters. And the entire 16-bit value can be represented by a 
combination of all four of these hex characters. For example, the 16 bits 

11110000 10101010 

can be represented with the hex characters 



Alternately, the left byte can be represented by an FO hex, and the right 
byte can be expressed as AA hex. There is no problem here since each hex 
character represents four bits, and both 8 and 16 are evenly divisible by 4. 

Octal representation is more complex. In this case, each octal character 
represents three bits (or sometimes two). Since neither 8 nor 16 is evenly 
divisible by 3, a problem can occur. Consider the 16-bit value 

1 111 010 Oil 101 010 

It can be represented in the octal notation as 



This is the result that the program in Listing 8.13 would produce at the 
system console. The problem is that the 16 bits are actually stored in two 
adjacent 8-bit locations. If the bit pattern is grouped into 8-bit bytes, it 
looks like this. 

11 110 100 11 101 010 

In this arrangement, the two corresponding octal bytes are represented as 



The result, which has been termed split octal or crazy octal, looks very 
different from the corresponding 16-bit octal value of 172352. The two 
octal bytes of split-octal notation are sometimes separated by a colon to 
distinguish the representation from the regular 16-bit octal. 



FOAA 



172352 



364 352 



364:352 
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The split-octal notation can be readily implemented, as shown in 
Listing 8.15. This program is adapted from the 8-bit octal-to-binary and 
binary-to-octal routines given in Listings 8.7 and 8.14. The first part takes 
two separate octal bytes and converts them to an 8-bit binary number. The 
second part converts the binary byte into two octal bytes. Each split-octal 
number is entered from the console as two groups of three characters. A 
space or colon can be used to separate the two parts. 

Listina 8.15. Split-octal routines 

t 6 OCTAL CHARACTERS SEPARATED BY A 

? SPACE ARE ENTERED FROM THE CONSOLE. 

i A 16-BIT BINARY NUMBER IS PRODUCED 

t IN DfE. THIS IS RECONVERTED TO OCTAL 
> 

i THIS PROGRAM IS DESIGNED TO OPERATE 

i WITH THE SYSTEM MONITOR AT 5800 HEX 
f 

i JAN 22 f 80 
i 



5000 




ORG 


5000H 






5800 




f 

HON IT 


EQU 


5800H 




5806 




OUTT 


EQU 


MONIT+6 




580C 




INPLN 


EQU 


MONIT+OCH 


580F 




GETCH 


EQU 


MONIT+OFH 


5812 




OUTHX 


EQU 


M0NIT+12H 


5000 


3E0D 


5 

START! 


mi 


A p ODH 


^CARR RET 


5002 


CD0658 




CALL 


OUTT 




5005 


3E0A 




MVI 


ApOAH 


5 LINE FEED 


5007 


CD0658 




CALL 


OUTT 




500A 


CD0C58 




CALL 


INPLN 


5 GET A LINE 


SOOD 


CD2350 




CALL 


0CT88 


56 OCT CHAR 


5010 


4A 




MOW 


CrD 


pFIRST 


5011 


CD1258 




CALL 


OUTHX 


JTO HEX 


5014 


4B 




Moy 


CfE 


! SECOND 


5015 


CD1258 




CALL 


OUTHX 


?T0 HEX 


5018 


3E20 




MVI 


A»' ' 


? BLANK 


501A 


CD0658 




C AL.L. 


OUTT 




501D 


CD6850 




CALL 


0UT80 


;T0 BINARY 


5020 


C30050 




JMP 


START 


JNEXT VALUE 






> 

? 6 SPLIT-OCTAL 


CHAR TO 


16-BIT BINAI 


5023 


CD3250 


OCT885 


CALL 


OCT 8 


5FIRST 


5026 


51 




Moy 


Di-C 


JSAVE 


5027 


CD0F58 




CALL 


GETCH 


5 SPACE 


502A 


DA5F50 




JC 


ERR3 


pONLY 1 CHAI 


502D 


CD3250 




CALL 


0CT8 


p SECOND 


5030 


59 




MOV 


EpC 


pSAVE 


5031 


C9 




RET 







p 
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i TO 8-BIT BINARY NUMBER IN C 
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5032 


CD4C50 


0CT8 J 


CALL 


OCTIN 


> 1ST CHAR 


5035 


FE04 




CPI 


4 


f FIRST 


5037 


D25E50 




JNC 


ERROR 


fTOO LARGE 


503A 


87 




ADD 


A 


? TIMES 2 


503B 


87 




ADD 


A 


niMES 4 


503C 


87 




ADD 


A 


fTIMES 8 


503D 


4F 




MOV 


C»A 


fSAVE BYTE 


503E 


CD4C50 




CALL 


OCTIN 


I2ND CHAR 


5041 


Bl 




ORA 


C 


f COMBINE 


5042 


87 




ADD 


A 


5 TIMES 2 


5043 


87 




ADD 


A 


» TIMES 4 


5044 


87 




ADD 


A 


jTIMES 8 


5045 


4F 




MOV 


Cf A 




5046 


CD4C50 




CALL 


OCTIN 


f3RD CHAR 


5049 


Bl 




ORA 


C 


7 COMBINE 


504A 


4F 




MOV 


Cf A 


5 SAVE IN C 


504B 


C9 




RET 










; CONVERT INPUT CHARACTER 0-7 TO B. 


504C 


CD0F58 


octin: 


CALL 


GETCH 




504F 


DA5C50 




JC 


ERR2 


fNO CHAR 


5052 


D630 




SUI 


'0' 


fASCII BIA! 


5054 


DA5D50 




JC 


ERR2 


fTOO SMALL 


5057 


FE08 




CPI 


8 




5059 


D25D50 




JNC 


ERR2 


ITOO LARGE 


505C 


C9 




RET 










t PRINT 


? ON 


IMPROPER 


INPUT 


505D 


CI 


ERR2: 


POP 


B 


iiRAISE STA( 


505E 


CI 


ERROR i 


POP 


B 




505F 


CI 


ERR3 ; 


POP 


B 




5060 


3E3F 




MVI 


Af '?' 




5062 


CD0658 




CALL 


OUTT 




5065 


C30050 




JMP 


START 


fTRY AGAIN 



> 16-BIT BINARY IN DfE TO SPLIT OCTAL 



5068 4A 

5069 CD7250 
506C 3E3A 
506E CD0658 
5071 4B 



OUTSO: 



MOV 

CALL 

MVI 

CALL 

MOV 



CrD 

OCT 
Af ' 5 ' 
OUTT 
C»E 



f FIRST BYTE 
?T0 OCT 

5 SEPARATOR 
j SECOND 



5072 79 

5073 07 

5074 07 

5075 E603 
5077 CD8450 
507A 79 
507B OF 
507C OF 
507D OF 
507E Cn8250 



> 
f 

OCT! 



ROUTINE TO OUTPUT AN 
VALUE AS THREE OCTAL 



MOV 

RLC 

RLC 

ANI 

CALL 

MOV 

RRC 

RRC 

RRC 

CALL 



AfC 



3 

0CT3 
A»C 



0CT2 



8-BIT BINARY 
CHARACTERS 

5GET IT 

52 HIGH BITS 

f MASK 

jGet again 

fMIDDLE BITS 
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5081 79 

5082 E607 
5084 C630 
5086 C30658 



0CT2; 
0CT3J 



MOM 
ANI 
ADI 
JMP 



'0' 
OUTT 



Af C 

7 



5RI6HT BITS 
iZ BITS 
5ASCII BIAS 
rPRINT 



5089 



END 



The input number is converted into a 16-bit binary number in the D,E 
register pair by calling the 8-bit routine twice. The hex value is printed out 
as usual, then the split-octal version. A colon in the middle separates the 
two halves. 

Assemble the program and try it out. 

>177 377 (a space sep-arstor) 
7FFF 177! 377 

>i00t200 (a colon separator) 
4080 i00;200 

This completes the base-conversion routines. At this point, you may want to 
incorporate some of these routines into your system monitor. 



CHAPTER NINE 

Paper Tape and 
Magnetic Tape Routines 



It is possible to encode complete programs, such as a BASIC interpreter, into 
ROM so that calculations, such as the square root of 19, can be performed as 
soon as the computer is turned on. But more complicated problems will 
require a source program. If the source program is used frequently, then it 
would be inconvenient to reenter the source program each time it is needed. 
One way to avoid this reentry problem is to save the source program some- 
how and then reload it into the computer when it is needed. 

But BASIC is not the only computer language. Some tasks are more 
easily performed with other languages, such as Pascal or APL. Assembly 
language is useful for systems programming. A full text editor program has 
more features than the most complex BASIC interpreter. Thus, it is better 
not to have the BASIC interpreter in ROM. Instead, a small monitor pro- 
gram, such as the one developed in Chapter 6, can be placed in ROM. We 
can use this small monitor to load larger programs from an external medium. 

The floppy disk is a convenient medium for saving and reloading 
programs. The cost, however, is greater than other storage media such as 
paper tape or magnetic tape. Even if a floppy-disk system is utilized for 
program storage, it might be wise to make backup copies on magnetic or 
paper tape. 

The simplest storage method is to utilize the paper tape accessory 
available on some Teletype machines. With this approach, a separate com- 
puter I/O port is unnecessary. Furthermore, paper tapes can be read directly 
on the Teletype, without using a computer. The disadvantage of this method 
is that the transfer rate is low, since the Teletype operates at only ten char- 
acters per second. 

A more complicated, but faster, method utilizes an ordinary magnetic 
tape machine designed for home recording. In this case a separate I/O port 
will usually be necessary, but the advantage is that the recording rate is 
higher than for paper tape. Common data transfer rates range from 30 to 
over 120 characters per second. 
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The frequency response of audio tape recorders is limited to a maxi- 
mum of 10 to 20 kHz. But since the computer operates at 2 or 4 MHz, the 
signals from the computer cannot be directly copied onto tape. 

One solution is to convert the computer's digital signals into sine waves 
that can be easily recorded. A digital-to-analog (D/A) circuit is used for this 
purpose. When the recorded program is subsequently played back into the 
computer, a separate analog-to-digital (A/D) circuit reverses the process. It 
converts the signal from a sine wave back into the digital form. The D/A and 
A/D circuits are combined on a printed circuit board with the usual parallel- 
to-serial converter for the I/O port. 



THE CHECKSUM METHOD 

Two separate tape-handling routines are given in this chapter; both may be 
used with paper tape or magnetic tape. They are both suitable for storing 
binary object programs, ASCII-encoded source programs, or just a set of 
numbers. The information is stored in a file consisting of a sequence of 
records. Each record contains a checksum that is used to detect errors. 

Errors can be introduced at several places in the tape-recording and 
playback process. The proximity of AC power cords to audio signal lines can 
change the transmitted signal. Oxide layers may fall off the tape, or there 
may be a defective spot on the recording surface. If the recording and play- 
back heads are dirty, they can incorrectly render the signal. The A/D conver- 
sion step, when the tape is played back, can also give rise to errors. 

In addition to the data, each record stored on the tape contains the 
record length, the memory address of the record, and a checksum byte. The 
checksum byte is obtained by adding all of the data bytes in the record. 
When the tape is read back, the computer sums up the data and compares 
the result to the checksum value written on the tape at the end of the rec- 
ord. A discrepancy indicates an error. 

Since an 8-bit checksum is used in both programs, there are 256 possi- 
ble combinations. Any single load error in the record will be discovered by 
this method. In principle, it is possible that two errors in the same record 
will combine to produce the expected checksum value. In practice, however, 
this is not likely to be a problem. Double errors occur much less frequently 
than single errrors. Furthermore, in a well-tuned system, single errors should 
be infrequent. They are most likely to be caused by low-quality tape, a dirty 
head, or a mistuned A/D converter circuit. Buy the best tape you can and 
clem the heads often. A routine that can be used for aligning the A/D circuit 
is incorporated in the second tape routine given later in this chapter. 



AN ASCII-HEX TAPE PROGRAM 

The tape program given in Listing 9.1 is based on an ASCII-encoded hexa- 
decimal format. It can be used to produce paper tapes or magnetic tapes of 
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computer programs. It can even produce a tape of itself. The program is 
self-contained and assembled to run at 100 hex. No outside routines are 
required. An additional feature of this program is that it can punch readable 
labels on the leader of a paper tape. (Of course, this feature is not very 
useful for magnetic tape recordings.) The label routine is discussed in the 
next section of this chapter. 



Listing 9. 1 .HexadeciRtsl tape routines. 



t hexmon: a monitor to dump? load? and 







p 


VERIFY 


INTEL HEX 


CHECKSUM TAPES 






1 


WITH TAPE LABEL 


FOR HEADER 








title 


'heKmon 


with tlabel' 






nor: 

? 
f 


lOOH 










9 9 f 9 9 !f 9 


9 9 9 9 9 9 9 


999999999 


9999999999999999 


0010 


„ 


9 

RLEN 
1 


EQU 


16 


» RECORD LENGTH 


0010 




CSTAT 


EQU 


lOH 


} CONSOLE STATUS 


0011 


ss 


CDATA 


EQU 


CSTA r+1 


^CONSOLE DATA 


0001 




CIMSK 


EQU 


1 


?IN MASK 


0002 


= 


COMSK 


EQU 


2 


5 OUT MASK 


0006 




PSTAT 


EOU 


6 


> PUNCH STATUS 


0007 




PDATA 


EQU 


PSTAT+1 


; PUNCH DATA 


0001 




PIMSK 


EQU 


1 


5 PUNCH IN MASK 


0080 




POMSK 


EQU 


80H 


> PUNCH OUT MASK 


GOOD 




9 

CR 


EQU 


13 


5CARRAGE RETURN 


OOOA 




LF 


EQU 


10 


pLINE FEED 


007F 




DEL 


EQU 


127 




0008 




CTRH 


EQU 


8 


?"H CONSOLE BACKUP 


0000 




NNULS 


EQU 





? CONSOLE NULLS 






9 9 9 9 f r f 


9 9 9 9 9 9 9 


999999999 


9999999999999999999 


0100 


C37D01 


9 

START! 


JMP 


CONTIN 








9 

9 INPUT 


A BYTE 


from THE 


CONSOLE 


0103 


DBIO 


9 

inputt: 


IN 


CSTAT 




0105 


E601 




ANI 


CIMSK 




0107 


CA0301 




JZ 


INPUTT 




OlOA 


DBll 




IN 


CDATA 




OlOC 


E67F 




ANI 


7FH 


5STRIP PARITY . 


OlOE 


C9 




RET 







9 

9 OUTPUT A CHARACTER TO CONSOLE 
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01 OF F5 
0110 DBIO 
0112 E602 
0114 CAlOOl 

0117 Fl 

0118 D311 
OllA C9 



OUTTI PUSH PSW 
OUTWI IN CSTAT 
mi COMSK 
JZ OUTW 
POP PSW 
OUT CriATA 
RET 

i OUTPUT HrL TO CONSOLE 
} 16-BIT BINARY TO HEX 



OllB 4C OUTHL: MOV C,H fFETCH H 

one CD2001 CALL OUTHX » PRINT IT 

OllF 4D HOV CfL J FETCH L, PRINT IT 



i CONVERT A BINARY NUMBER TO TWO 
» HEX CHARACTERS f AND PRINT THEM 



0120 79 

0121 IF 

0122 IF 

0123 IF 

0124 IF 

0125 CD2901 
0128 79 



OUTHX : 



MOV 

RAR 

RAR 

RAR 

RAR 

CALL 

MOV 



A;C 



HEXl 

Af C 



j ROTATE 

f UPPER 

; CHARACTER 

■f TO LOWER 

) OUTPUT UPPER 

5 OUTPUT LOWER 



j OUTPUT A HEX CHARACTER 
f FROM LOWER FOUR BITS 



0129 E60F 
012B C690 
0120 27 
012E CE40 

0130 27 

0131 C30F01 



HEXll 



AN I 

ADI 
DAA 
ACl 
DAA 
JMP 



OFH 
144 

64 

OUTT 



f TAKE 4 BITS 

;daa trick 

pOnce again 



f CONVERT ASCII CHARACTER FROM CONSOLE 
} TO 4 BINARY BITS 



0134 
0136 
0137 
0139 
013A 
013B 
013D 
013E 
013F 
0141 
0143 



D630 

ne 

FE17 

3F 

DS 

FEOA 

3F 
DO 

D607 
FEOA 

C9 



NIB? 



SUI 

RC 

CP I 

CMC 

RC 

CPI 

CMC 

RNC 

SUI 

CPI 

RET 



'0' 

'F'- 

10 



'A' 
10 



» ASCII BIAS 
} < '0' 
'O' + l 

f INVERT 

p ERROR J > 'F' 

f INVERT 

f NUMBER IS 0-9 

'9'-l 

f CHARACTER IS A-F 



; INPUT HfL FROM CONSOLE 



0144 ns 

0145 C5 

0146 210000 
0149 CD0402 



READHLJ PUSH D 

PUSH B 

LXI Hf 

RDHL2: CALL GETCH 



» START WITH 
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014C 


DA6801 




JC 


RDHL5 


fEND OF LINE 


014F 


CD3401 




CALL 


NIB 


fCONMERT TO BINARY 


0152 


IIA5E01 




JC 


RDHL4 


?NOT HEX 


0155 


29 




DAD 


H 


f 16-BIT 


0156 


29 




DAD 


H 


f SHIFT LEFT 


0157 


29 




DAD 


H 




U 1 vJiJ 


OO 




DAD 


H 




V 1 DV 


J?vJ 




ORA 


L 


JCOMBINE NEU 




or 




MOV 








pTT A O A 1 




JMP 


RDHL2 


5 NEXT 






f 

i CHECK 


FOR 


COMMA OR BLANK 






f AT END OF 


ADDRESS 




015E 


FEFC 


W 

RDHL4; 


CPI 


' » '-'0' 


JCOMMA? 


0160 


CA6801 




JZ 


RDHL5 


?YES? OK 


0163 


FEFO 




CPI 




» BLANK? 


0165 


C26B01 




JNZ 


ERROR 


SNO 


0168 


CI 


RDHL5I 


POP 


B 




0169 


Dl 




POP 







016A 


C9 




RET 






Ol 6o 




error: 


MVI 


Af '?' 


fi T M Ct n C* CT Ct T M Ci 1 1 T 

9 inr hur c.r\ I Nr U 1 


A ■( i ri 
U16U 


ri A cr A ■* 
LUOr Ol 




CALL 


OUTT 




01 /O 


AA A •! 

CoOOOl 




JMP 


START 


f 1 C.LL liUW Ruriliy 






r SEND CHRACTERS POINTED 


1 1 U o Y ii IP c. 






; UNTIL 


A BINARY ZERO IS 


C" n 1 1 x.iT*i 
rUUNJLi 


0173 


lA 


sendm: 


LDAX 


D 


p NtX 1 BY 1 c. 


0174 


B7 




ORA 


A 


f bb.L 1 r ZLhU 


0175 


C8 




RZ 




f DONE 


0176 






CALL 


OUTT 




01 /y 


1 3 




INX 


D 




01 7 A 


T ~T T /\ < 




JMP 


SENDM 




A 1 "7 n 
vl / il 


"it -S O 1 A /. 

o i. ^ 1 Uo 


continj 


LXI 


SP. STACK 




A i O A 






LXI 


Df SIGN 


tMESSAGE 


A 1 DTT 
V 1 OO 






CALL 


SENDM 


fSEND IT 


A ^ O Z 




rstrt: 


LXI 


SP^STACK 




1 or 


r* Ti A /V •* 




CALL 


INPLN 


>6ET A LINE 


A 1 or* 


r* ri A ii AO 




CALL 


GETCH 


f INPUT THE TASK 


A 4 OCT 

018r 


Ft57 




CPI 


'W 


rDUMP 


0191 


wri ir» V 4^ 




JZ 


PDUMP 




0194 


FE52 




CPI 


'R' 


fREADf NO AUTOSTART 


0196 


CAE602 




JZ 


PLOAD 




0199 


FE45 




CPI 


'E' 


?LOAD AND EXECUTE 


0198 


CAE602 




JZ 


PLOAD 




019E 


FE5& 




CPI 


'M' 


^VERIFY 


OiAO 


CAE602 




JZ 


PLOAD 




01A3 


FE47 




CPI 


'G' 


5 60 SOMEWHERE 


01A5 


C26B01 




JNZ 


ERROR 










f f > > 1 


>>f>tttftrtt 


ifffifftffffttfftfr! 



9 



192 8080/Z-80 ASSEMBLY LANGUAGE 



f JUMP TO ANOTHER PROGRAM 



\j jLnci 






CALL 


READHL 


» JUMP ADDRESS 


OlAB 


E9 


JPCHLJ 


PCHL 




?OKr GOODBYE 






r INPUT A LINE 


FROM THE 


CONSOLE 






; AND 


PUT IT INTO A BUFFER 


01 AC 


CDEEOl 


f 

inpln: 


CALL 


CRLF 




OlAF 


3E3E 




MVI 


A ? ' > ' 


; COMMAND PROMPT 


OlBl 


CDOFOl 




CALL 


OUTT 


ISEND TO CONSOLE 


01B4 


212406 


INPL2I 


LXI 


Hs IBUFF 


? BUFFER ADDRESS 


0iB7 


222106 




SHLIi 


IBUFP 


t INITIALIZE POINTER 


OIBA 


OEOO 




MVI 


C?0 


r INITIALIZE COUNT 


OIBC 


CD0301 

W V w V A 


INPLI { 


CALL 


INPUTT 


;CHAR FROM CONSOLE 


OIBF 


FE20 




CP I 




J CONTROL CHAR? 


OiCl 






JC 


INPLC 


>YES» GO PROCESS 


01C4 


FE7F 




CPI 


DEL 


s DELETE CHAR? 


Cii PA 






JZ 


INPLB 


; YES 


01C9 


FE5B 




CPI 


'Z' + l 


; UPPER CASE? 


OICB 


DADOOl 




JC 


INPL3 


f NO 


OICE 


E65F 




mi 


5FH 


J MAKE UPPER 


OlDO 


77 


INPL3I 


MOM 


MrA 


»PUT IN BUFFER 


OlDl 


3E20 




MVI 


Af32 


5GET BUFFER SIZE 


01D3 


B9 




CMP 


C 


rTEST IF FULL 


01D4 


CABCOl 




JZ 


INPLI 


fYES? LOOP 


01D7 


7E 




MOV 


ApM 


5 RECALL CHARACTER 


01D8 


23 




I NX 


H 


JINCR POINTER 


01D9 


OC 




INR 


C 


rAND I NCR COUNT 


01 DA 


CDOFOi 


inple: 


CALL 


OUTT 


JECHO CHARACTER 


OIDD 


C3BC01 




JMP 


INPLI 


7GET NEXT CHAR 






i PROCESS CONROL CHARACTER 


OlEO 


FE08 


INPLC: 


CPI 


CTRH 


?"H? 


01E2 


CAF801 




JZ 


INPLB 


jYES 


01E5 


FEOD 




CPI 


CR 


5 TEST IF RETURN 


01E7 


C2BC01 




JNZ 


INPLI 


IHOf IGNORE CHAR 






i 

( END 


OF INPUT 


LINE 




OlEA 


79 


1 


MOV 


AfC 


fLINE COUNT 


OlEB 


322306 




STA 


IBUFC 


J SAVE 






i CARRIAGE RETURN » LINE 


FEED 


OlEE 


3E0D 


CRLFJ 


MVI 


A»CR 




OlFO 


CDOFOl 




CALL 


OUTT 




01F3 


3E0A 




MVI 


ArLF 





f 

i IF NULLS REQUIRED AFTER CR» LF 
» USE REPEAT MACRO 
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IF 


NNULS > 


? ASSEMBLE 








CALL 


OUTT 










XRA 


A 


?GET A NULL 








REPT 


NNULS~1 










CALL 


OUTT 










ENOM 












ENDIF 




JNULLS 






! 


JMP 


OUTT 








? 

f DELETE ANY 


PRIOR CHARACTER 




/V 


inplb: 


MOV 


A?C 


*jCHAR COUNT 


01F9 


B7 




ORA 


A 


5 ZERO? 


OlFA 


CABCOl 




JZ 


INPLI 


? YES 


OlFD 


2B 




DCX 


H 


J BACK POINTER 


OlFE 


OD 




OCR 


C 


;and count 


OlFF 


3E08 




MMI 


AfCTRH 


?BACK" CURSOR 


0201 


C3DA01 




JMP 


INPLE 


f PRINT IT 



f OBTAIN A CHARACTER FROM THE CONSOLE 
f BUFFER. SET CARRY IF EMPTY. 



0204 


E5 


getch: 


PUSH 


H 


5 SAME REGS 


0205 


2A2106 




lhld 


IBUFP 


JGET POINTER 


0208 


3A2306 


GETC2J 


LDA 


IBUFC 


?GET COUNT 


020B 


0601 




SUI 


1 


fDECR WITH CARRY 


020D 


DA1802 




JC 


GETC4 


?N0 CHARACTERS 


0210 


322306 




STA 


IBUFC 


J REPLACE COUNT 


0213 


7E 




Moy 


AsM 


JGET CHARACTER 


0214 


23 


GETC3J 


INX 


H 


flNCR POINTER 


0215 


222106 




SHLIi 


IBUFP 


p REPLACE POINTER 


0218 


El 


eETC4l 


POP 


H 


f RESTORE REGS 


0219 


C9 




RET 




5CARRY IF NO CHAR 






r f f f t f > 


ttftttff 




ffffffrffffifitiii 






f 

t PUNCH 


A PAPER 


TAPE 




021A 


CD4401 


PDUMPI 


CALL 


READHL 


?START ADDRESS 


02in 


DA6B01 




JC 


ERROR 


fTOO FEW PARAM 


0220 


EB 




xchg 






0221 


C04401 




CALL 


READHL 


?STOP ADDRESS 


0224 


EB 




XCHG 






0225 


13 




INX 


n 




0226 


E5 




PUSH 


H 




0227 


CD4401 




CALL 


READHL 


^AUTOSTART ADDR 


022A 


E3 




XTHL 




pPUT ON STACK 


022B 


008502 




CALL 


LEADR 


f PUNCH LEADER 


022E 


CD8404 




CALL 


LABEL 


SPUNCH LABEL 






> 

f START 


NEU RECORD f ZERO THE CHECKSUM 






f PUNCH 


CR» LFj 


2 NULLS 


AND COLON 


0231 


CDD002 


t 

NEWREC: 


CALL 


PCRLF 


»CRr LFf NULLS 



r FIND THE RECORD LENGTH 



194 8080/Z-80 ASSEMBLY LANGUAGE 



0234 


7B 






A f E 


» COMPARE LOW STOP 


0235 


95 




SUB 


L 


f TO LOW POINTER 


0236 


4F 




Moy 


Cfh 


(DIFFERENCE IN C 


0237 


7A 




MOM 


Af D 


f COMPARE HIBH STOP 


0238 


9C 




SBB 


H 


> TO HIGH POINTER 


0239 


47 




MOV 


BfA 


sDIFhtRENCE TO B 


023A 


DA6B01 




JC 


ERROR 


f IMPROPER? HfL D?E 


023D 


3E10 




MVI 


ArRLEN 


fFULL RECORD 


023F 


C24C02 




JNZ 


NEW2 




0242 


B9 




CMP 


C 


» COMPARE TO E-L 


0243 


riA4C02 




JC 


NEW2 


IFULL RECORD LENGTH 


0246 


78 




MOV 


ArB 


; ARE BOTH E-L AND 


0247 


Bl 


f 


ORA 


C 


i D-E ZERO? 


0248 


CA6802 




JZ 


DONE 


» YES? REC LENGTH = 


024B 


79 




MOV 


A?C 


? SHORT RECORD 


024C 


4F 


NEU2: 


MOV 


Cf A 


{RECORD LENGTH TO C 


024D 


0600 




MVI 


BfO 


?ZERO THE CHECKSUM 


024F 


Cn9502 




CALL 


ff^a kill \J 

PNHEX 


? PUNCH RECORD LENGTH 


0252 


CD9002 




CALL 


PUNHL 


? PUNCH H/L 


0255 


AF 




XRA 


A 




0256 


Cn9502 




CALL 


PNHEX 


f PUNCH RECORD TYPE 


0259 


7E 


PMEMJ 


MOV 


Af M 




025A 


CD9502 




CALL 


PNHEX 


(PUNCH MEMORY BYTE 


025D 


23 




INX 


H 


J I NCR. MEMORY POINTER 


025E 


OD 




DCR 


C 


?DECR RECORD LENGTH 


025F 


C25902 




JNZ 


PMEM 




0262 


CD6703 




CALL 


CSUM 


(PUNCH CHECKSUM 


0265 


C33102 




JMP 


NEUREC 


(NEXT RECORD 






f 

r FINISHED? PUNCH LAST 


RECORD? RECORD 






i LENGTH 00 f 


THE START 


ADDRESS? 






f AND 


A RECORD TYPE OF 


01 


0268 


AF 


i 

done: 


XRA 


A 




0269 


47 




MOV 


Bf A 


9 ZERO LHbLKbUn 


026A 


CD9502 




CALL 


PNHEX 


p ZERO RECORD LEN * 


026D 


El 




POP 


H 




026E 


Cn9002 




CALL 


PUNHL 


? AUTOSTART H/L 


0271 


7C 




MOV 


A»H 


(CHECK FOR 


0272 


B5 




ORA 


L 


( AUTOSTART 


0273 


3E00 




MVI 


ArO 


(0 WITH CARRY 


0275 


CA7902 




JZ 


D0N2 


(NO AUTOSTART 


0278 


3C 




INR 


A 




0279 


CD9502 


D0N2 i 


CALL 


PNHEX 


(RECORD TYPE 1 


027C 


CD6703 




CALL 


CSUM 


(PUNCH CHECKSUM 


027F 


CD8502 




CALL 


LEADR 


(PUNCH TRAILER 


0282 


C38601 




JMP 


RSTRT 


(NEXT JOB 






i PUNCH BLANK 


HEADER AND TRAILER 


0285 


AF 


f 

LEADRJ 


XRA 


A 




0286 


063C 




MVI 


B f 60 


(TAPE NULLS 


0288 


CDB802 


NLDR} 


CALL 


POUT 




028B 


05 




DCR 


B 




028C 


C28802 




JNZ 


NLDR 




028F 


C9 




RET 







? 
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; PUNCH THE HfL REGISTER PAIR 



0290 7C PUNHLJ MOV A»H f FETCH H 

0291 CD9502 CALL PNHEX J PUNCH IT 
0294 7D MOV CitL f GET L. PUNCH 



IT 



? CONVERT A BINARY NUMBER TO TWO HEX 

f CHARACTERS. PUNCH THEM. ADD TO CHECKSUM 



0295 


F5 


PNHEX t 


PUSH 


PSW 


?SAVE ON STACK 


0296 


80 




ADD 


B 


SADD TO CHECKSUM, 


0297 


47 




MOV 


B.A 


.SAVE IT IN B 


0298 


Fl 




POP 


PSW 


.'RETRIEVE BYTE 


0299 


F5 




PUSH 


PSW 




029A 


IF 




RAR 






029B 


IF 




RAR 




(ROTATE UPPER 


029C 


IF 




RAR 






029D 


IF 




RAR 




?T0 LOWER 


029E 


CDA202 




CALL 


PHEXI 


J LEFT CHARACTER 


02A1 


Fl 




POP 


PSW 


(RIGHT CHARACTER 






i PUNCH 


A HEX 


CHARACTER 


FROM 






1 LOWER 


FOUR 


BITS 




02A2 


E60F 


1 

PHEXi: 


ANI 


OFH 


r MASK UPPER 4 BI 


02A4 


C690 




AD I 


144 




02A6 


27 




OAA 






02A7 


CE40 




AC I 


64 




02A9 


27 




DAA 






02AA 


C3B802 




JMP 


POUT 








p 

5 INPUT 


A HEX 


CHARACTER 


FROM TAPE 


02AD 


CDC402 


1 

hex: 


CALL 


PIN 




02B0 


0630 




SUI 


'0' 




02B2 


FEOA 




CPI 


10 




02B4 


08 




RC 




fO-9 


02B5 


0607 




SUI 


7 


JA-F 


02B7 


C9 




RET 










f OUTPUT A BYTE TO THE 


PUNCH 


02B8 


F5 


POUT! 


PUSH 


PSW 




02B9 


DB06 


poutm; 


IN 


PSTAT 




02BB 


E680 




ANI 


POMSK 




02BD 


C2B902 




JNZ 


POUTW 




02C0 


Fl 




POP 


PSW 




02C1 


D307 




OUT 


PDATA 




02C3 


C9 




RET 










f 

} INPUT 


A BYTE FROM PAPER TAPE 


02C4 


DB06 


5 

pin: 


IN 


PSTAT 




02C6 


E601 




ANI 


PIMSK 




02C8 


C2C472 




JNZ 


PIN 




02CB 


DB07 




IN 


PDATA 




02CD 


E67F 




ANI 


7FH 


.STRIP PARITY 


02CF 


C9 




RET 
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} PUNCH 


CR> LFf 


NULLS 


AND COLON 


02D0 


3E0D 


> 

pcrlf; 


HVI 


A»CR 




02D2 


CDBB02 




CALL 


POUT 




02D5 


3E0A 




MVI 


A»LF 




0207 


CDB802 




CALL 


POUT 




02DA 


AF 




XRA 


A 




02DB 


CDB802 




CALL 


POUT 


5 TWO NULLS 


02DE 


CDB802 




CALL 


POUT 




02E1 


3E3A 




MVI 


A? ' : ' 


»COLON 


02E3 


C3B802 




JMP 


POUT 








))f it f iff (f riff rrriifiiififiiiftti 






i ENTRY 


FOR LOADr EXECUTE AND VERIFY 


02E6 


320006 


'f 

PLOAn: 


STA 


TASK 




02E9 


3E11 




MVI 


Arl7 


fTAPE READER ON 


02EB 


CDB802 




CALL 


POUT 




02EE 


CD4401 




CALL 


READHL 


J OFFSET 


02F1 


220106 




SHLD 


OFSET 


5 SAVE IT 






r PROCESS THE RECORD HEADING ON INPUT 


02F4 


CnC402 


head: 


CALL 


PIN 


» INPUT FROM TAPE 


02F7 


FE3A 




CPI 


' : ' 


J COLON? 


02F9 


C2F402 




JNZ 


HEAD 


INOf TRY AGAIN 


02FC 


0600 




HVI 


BrO 


5 ZERO THE CHECKSUM 


02FE 


CD3303 




CALL 


PHEX 


f RECORD LENGTH 


0301 


B7 




ORA 


A 


ilS IT ZERO? 


0302 


CA4403 




JZ 


ENDFL 


fYESp DONE 


0305 


4F 




MOV 


C»A 


fSAVE REC. LEN. 


0306 


CD2B03 




CALL 


TAPEHL 


»6ET H/L 


0309 


EB 




XCHG 




JADDR TO Df E 


030A 


2A0106 




LHLD 


OFSET 


JGET OFFSET 


030D 


19 




DAD 


D 


f ADD 


030E 


CD3303 


loop: 


CALL 


PHEX 


f INPUT DATA BYTE 


0311 


5F 




MOV 


ErA 


»SAVE BYTE 


0312 


3A0006 




LDA 


TASK 


5 GET TASK 


0315 


FE56 




CPI 


'V 


JSEE IF VERIFYING 


0317 


7B 




MOV 


AfE 


IHOVE BACK 


0318 


CA1C03 




JZ 


SKIP 


> JUMP IF VERIFYING 


031B 


77 




MOV 


MrA 


pDATA to MEMORY 


031C 


BE 


skip: 


CMP 


M 


» CHECK MEMORY 


031D 


C27603 




JNZ 


MERROR 


;bad memory 


0320 


23 




INX 


H 


» INCREMENT POINTER 


0321 


OD 




DCR 


C 


>DECR RECORD LEN 


0322 


C20E03 




JNZ 


LOOP 


J NOT YET ZERO 


0325 


CD6D03 




CALL 


CHECK 


EPROCESS CHECKSUM 


0328 


C3F402 




JMP 


HEAD 


f START NEXT RECORD 






) INPUT 

1 


HrL AND 


RECORD 


TYPE FROM TAPE 


032B 


CD3303 


tapehl: 


CALL 


PHEX 


pREAD H 


032E 


67 




MOV 


HfA 




032F 


CD3303 




CALL 


PHEX 


SREAD L 


0332 


6F 




MOV 


L»A 


IREAD RECORD TYPE 



p 

f CONVERT 2 CHAR FROM TAPE TO ONE BINARY 
r yORDo STORE IN A AND ADD TO CHECKSUM 
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rns: A ♦ 






P Ur r trv UiiHINrit/ 1 Ci\ 


0336 


07 




RLC 






0337 


17 




[Ti A 1 




pHUVt 1 U Urrtrv 




1 / 




KmL 






0339 


17 




RAL 




pHALF 


033A 


5F 




MOV 


E?A 


pSave it 


033B 


CDAD02 




CALL 


HEX 


p LOWER CHARACTER 


033E 


83 




ADD 


E 


> COMBINE BOTH 


033F 


5F 




MOV 


E SI A 


* C A lie T T 


0340 


80 




ADD 


B 


SAtsn Tn piJsrf*ik*diM 
f HUu lU unic.L/i\oUri 


0341 


47 




MOV 


B;A 




0342 


7B 




MOV 


A;E 


* CiCTEi TCI If r*ATA 


0343 


C9 




RET 










p 

f ROUTINE TO CHECK FOR 






¥•« '1 ?S A *T 


endfl: 


CALL 


TAPEHL 
















0%54 / 


r D 




PUSH 


PSW 










CALL 


PHEX 


p INPUT CHECKSUM 


034B 


CD6203 




CALL 


TOFF 


pTAPE READER OFF 


034E 


Fl 




POP 


PSW 


p RETRIEVE REC TYPE 


034F 


FEOl 




CPI 


1 


p AUTOSTART? 


0351 


C2B601 




JNZ 


RSTRT 


pNO 








LDA 


TASK 


• rUFTK TA<iK 


0357 


FE45 




CPI 


'E' 


p EXECUTE? 


0359 


CAABOl 




JZ 


JPCHL 


pYESp 60 THERE 


035C 


CDlBOl 




CALL 


OUTHL 


pNOp PRINT HL 


035F 


C38601 




JMP 


RSTRT 


pNEXT TASK 






; TURN 


OFF TAPE 


READER 




0362 


3E13 


9 

toff: 


MVI 


Ap 19 




0364 


C3B802 




JMP 


POUT 








r CALCULATE AND 


PUNCH 


THE CHECKSUM 




7R 
/ o 


CSUHI 


MOV 


ApB 


p CHECKSUM TO A 


Uaoo 


OCT 




CMA 




p ONE'S COMPLEMENT 


0369 


3C 




INR 


A 


5 TWO'S COMPLEMENT 


036A 


C39502 




JMP 


PNHEX 


p PUNCH CHECKSUM 






r SEE IF CHECKSUM IS CORRECT (ZERO) 


036n 


CD3303 


check; 


CALL 


PHEX 


p INPUT CHECKSUM 


0370 


AF 




XRA 


A 




03/1 


80 




ADD 


B 


pIS CHECKSUM ZERO? 


0372 


C8 




RZ 




pYESp return 






» p f » > > » 


» p p f J f ? f 


! f f f 9 > f 


pppppppppppppppppppp 






f ERROR 


MESSAGES 




0373 


3E43 


5 


MVI 


Aj 'C 


p CHECKSUM ERROR 


0375 


01 




DB 


1 


JDB TRICK TO SKIP 


0376 


3E4D 


MERROR ! 


MVI 


Ap 'M' 


pM for bad MEMORY 


0378 


F5 




PUSH 


PSW 




0379 


CD6203 




CALL 


TOFF 


J TAPE READER OFF 
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037C 


Fl 


POP 


PSW 


0370 


CDOFOl 


CALL 


OUTT fPRINT ERROR TYPE 


0380 


CDlBOl 


CALL 


OUTHL fPRINT H/L 


0383 


C38601 


JMP 


RSTRT 


0386 


i 

ODOA sign; 


DB 


CRfLF 


0388 


4865782070 


DB 


'Hex paper-tape prosirsoi ' 


039E 


ODOAOA 


DB 


CRjLFc LF 


03A1 


45202n206C 


DB 


'E - load and execute' 


03B5 


ODOA 


DB 


CR?LF 


03B7 


47202D2067 


DB 


'6 - £io to addresses aiven' 


03D0 


ODOA 


DB 


CRfLF 


03D2 


52202D2072 


DB 


'R - read tape into memora' 


03EB 


ODOA 


DB 


CRfLF 


03ED 


2020202028 


DB 


' (with optional offset)' 


0407 


ODOA 


DB 


CRfLF 


0409 


56202D2076 


DB 


'V - verify tape against' 


0420 


206D65606F 


DB 


' metnoru' f CRpLF 


0429 


57202D2077 


DB 


'W - write paper tape' 


043D 


2028616E64 


DB 


' (and labeD'fCRfLFf ' 


044F 


2877697468 


DB 


' (with optional autostart ) ' 


0468 


ODOAOO 


DB 


CRf LFfO 


046B 


0D0A456E74LMESG: 


DB 


CRf LFf 'Enter leader messase' 


0481 


ODOAOO 


OB 


CRf LFf 




f 

i PUNCH 


READABLE LABELS ON PAPER TAPE 


0484 


E5 label: 


PUSH 


H' 


0485 


D5 


PUSH 





0486 


116B04 


LXI 


DfLMESG fLABEL MESS. 


0489 


CD7301 


CALL 


SENDM fSEND IT 


048C 


CDACOl 


CALL 


INPLN f GET A LINE 


048F 


CD0402 LABLl t 


CALL 


GETCH >GET CHARACTER 


0492 


DABF04 


JC 


LABL2 (DONE ON CARRY 


0495 


DE20 


SBI 


20H f ASCII BIAS 


0497 


DA8F04 


JC 


LABLl f < SPACE 


049A 


FE3F 


CP I 


63 


049C 


D28F04 


JNC 


LABLl f TOO BIG 


049F 


6F 


MOV 


L f A 


04A0 


5F 


MOV 


E f A 


04A1 


2600 


MVI 


Hf 


04A3 


1600 


MVI 


Df 


04A5 


29 


DAD 


H ; DOUBLE IT 


04A6 


29 


DAD 


H f TIMES 4 


04A7 


19 


DAD 


D fTIMES FIVE 


04A8 


EB 


XCHG 




04A9 


21C504 


LXI 


Hf TABL 


04AC 


19 


DAD 


D 


04AD 


0E05 


MVI 


Cp5 


04AF 


7E NEXTC; 


MOV 


Af M 






CALL 


POUT 


04B3 


23 


I NX 


H 


04B4 


OD 


OCR 


C 


04B5 


C2AF04 


JNZ 


NEXTC 


04B8 


AF 


XRA 


A 


04B9 


CDB802 


CALL 


POUT 


04BC 


C38F04 


JMP 


LABLl f NEXT CHARACTER 
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04BF 


Cn8502 LABL2J 


CALL 


04C2 


01 




POP 


0463 


El 




POP 


04C4 


C9 




RET 


04C5 


0OOO000OOOTABL5 


DB 


04CA 


OOOOCFCFOO 




DB 


04CF 


0007000700 




DB 


04D4 


28FE28FE28 




DB 


04D9 


4689FF8972 




DB 


04DE 


462610C8C4 




DB 


04E3 


6C92AC40AO 




OB 


04E8 


0004030300 




DB 


04ED 


003C428100 




OB 


04F2 


OO81423C00 




OB 


04F7 


8850F85088 




DB 


04FC 


08087E0808 




DB 


0501 


0080703000 




OB 


0506 


0808080808 




DB 


050B 


OOCOCOOOOO 




OB 


0510 


4020100804 




DB 


0515 


7EA189857E 




DB 


051A 


8482FF8080 




DB 


051F 


C2A1918986 




DB 


0524 


4289898976 




DB 


0529 


0C0A89FF88 




DB 


052E 


6789898971 




DB 


0533 


7E89898972 




DB 


0538 


0101F90503 




DB 


053D 


7689898976 




OB 


0542 


468989897E 




OB 


0547 


OOD8D80000 




DB 


054C 


0080763600 




DB 


0551 


1028448200 




DB 


0556 


2828282828 




OB 


055B 


8244281000 




DB 


0560 


0601B90906 




DB 


0565 


7E819D910E 




DB 


056A 


FE090909FE 




DB 


Q56F 


81FF898976 




DB 


0574 


7E81818142 




DB 


0579 


81FF81817E 




DB 


057E 


FF89898989 




DB 


0583 


FF09090901 




OB 


0588 


7E81919172 




DB 


058D 


FF080808FF 




DB 


0592 


0081FF8100 




DB 


0597 


6080817F01 




DB 


059C 


FF081422C1 




DB 


05A1 


FF80808080 




DB 


05A6 


FF020C02FF 




DB 


05AB 


FF023C40FF 




DB 


05B0 


FF818181FF 




DB 


05B5 


0509090906 




DB 


05BA 


7E81A141BE 




OB 


05BF 


FF19294986 




DB 


05C4 


4689898972 




DB 


05C9 


OlOlFFOlOl 




DB 



LEADR 


H 



Of Of Of Of > SPACE 
Of Of 207f 207f0 f EXCL 
Of 7f Of 7f f ' 
40f 254f 40f 254 f 40 I # 
70 f 137f 255f 137f 114 f % 
70f 38 f 16f 200.f 196 > X 
108f 146f 172f64f 160 i S 
Of 4 f 3f 3f f ' 
Or 60 f 66f 129f f ( 
Of 129f66f 60f f ) 
136f 80f 248f80f 136 I * 
8f 8f 126f 8f 8 f + 
Of 128f 112f 48f f f 
8f 8f 8f 8f 8 f - 
Of 192f 192f Of f . 
64 f 32? 16f 8r 4 5 / 
126f 161»137f 133f 126 5 
132fl30f255f 128.128 i 1 
194fl61fl45f 137.134 ? 2 
66 f 137f 137f 137. 118 f 3 
12f lOf 137f255f 136 i A 
103f 137f 137f 137f 113 f 5 
126f 137f 137f 137f 114 t 6 
If If 249f 5f 3 f 7 
118f 137f 137f 137f 118 i 8 
70 f 137f 137f 137f 126 i 9 
Of 216f 216f0f f : 
Of 128f 118f54f I f 
16f 40f 68 f 130f f < 
40 f 40f 40 f 40f 40 f = 
130f 68f 40 ff 16 f f > 
6f If 185f9f 6 f ? 
126f 129f 157f 145f 14 5 
254f 9f 9. 9f 254 i A 
129f255. 137. 137.118 J B 
126f 129f 129f 129f 66 t C 
129f255f 129.129f 126 f D 
255.137f 137f 137f 137 i E 
255 f9f 9 .9 f 1 ; F 
126f 129f 145f 145f 114 } G 
255f8f 8f 8'f 255 i H 
Of 129.255f 129»0 I I 
96 f 128f 129f 127f 1 > J 
25Sf 8f 20 f 34 f 193 f K 
255f 128f 128f 128f 128 » L 
255f 2f 12f 2f 255 f M 
255f 2f 60 f 64 f 255 f N 
255f 129. 129f 129f255 > 
5f 9f 9f 9. 6 f P 
126f 129f 161f65. 190 I Q 
255f25f 41f 73 f 134 1 R 
70f 137f 137f 137f 114 i S 
If If 255.1. 1 f T 
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TP er rt Q A "? c* 




■s 07 - 

M,iS. / 9 


128» 


128»128f 127 5 


u 


05D3 


0F30C0300F 


DB 


15? 


48 1- 


192^48? 15 5 


V 


05D8 


7F8070807F 


DB 


127» 


128» 


1129l28?127 p 


u 




U *£ X ^ L/ 


U0 


XT 3 P 


36 f 


24 «■ 36? 195 f 


y 
A 








9 


4 ? 


248i'4 »3 1 


Y 




n A 1 Q 1 




ATOP 


161»145»137»135 f 


7 




s/\/~ r 1, .& X 






255 p 


129»129»129 f 


r 


05F1 


04081 02040 


DB 


4 7 


8i> 


16f 32f 64 ; 


\ 


05F6 


818181FF00 


DB 


129» 


129i. 


129»255»0 f 


3 


05FB 


0C0201020C 


DB 


12f 


2f 


1 f 2i> 12 f 




0600 


TASK! 


DS 


1 




fSAME IT 




0601 


0000 OFSETI 


nu 







rLOAD OFFSET 




0603 




DS 


30 




f STACK SPACE 






stack; 












0621 


ibufp: 


DS 


2 




f BUFFER POINTER 


0623 


IBUFC: 


DS 


1 




» BUFFER COUNT 




0624 


IBUFFI 


DS 


20 




» INPUT BUFFER 




0638 


> 


END 











Symbols' 



0011 


CBATA 


036D 


CHECK 


0001 


CIMSK 


0002 


COMSK 


01 7D 


CONTIN 


OOOD 


CR 


OlEE 


CRLF 


0010 


CSTAT 


0367 


CSUH 


0008 


CTRH 


007F 


DEL 


0279 


D0N2 


0268 


DONE 


0344 


ENDFL 


016B 


ERROR 


0208 


GETC2 


0214 


GETC3 


0218 


GETC4 


0204 


GETCH 


02F4 


HEAD 


0129 


HEXl 


02AD 


HEX 


0623 


IBUFC 


0624 


I BUFF 


0621 


IBUFP 


01B4 


INPL2 


OlDO 


INPL3 


01F8 


INPLB 


OlEO 


INPLC 


OlDA 


INPLE 


OIBC 


INPLI 


OlAC 


INPLN 


0103 


INPUTT 


OlAB 


JPCHL 


0484 


LABEL 


048F 


LABLl 


04 BF 


LABL2 


0285 


LEADR 


OOOA 


LF 


046B 


LMESG 


030E 


LOOP 


0376 


MERROR 


024C 


NEW2 


0231 


NEUREC 


04AF 


NEXTC 


0134 


NIB 


0288 


NLDR 


0000 


NNULS 


0601 


OFSET 


OllB 


OUTHL 


0120 


OUTHX 


OlOF 


OUTT 


0110 


OUTW 


02D0 


PCRLF 


0007 


PDATA 


021A 


PDUMP 


02A2 


PHEXl 


0333 


PHEX 


0001 


PIMSK 


02C4 


PIN 


02E6 


PLOAD 


0259 


PMEM 


0295 


PNHEX 


0080 


POMSK 


02B8 


POUT 


02B9 


POUTW 


0006 


PSTAT 


0290 


PUNHL 


0149 


RDHL2 


015E 


RDHL4 


0168 


RDHL5 


0144 


READHL 


0010 


RLEN 


0186 


RSTRT 


0173 


SENDM 


0386 


SIGN 


031C 


SKIP 


0621 


STACK 


0100 


START 


04C5 


TABL 


032B 


TAPEHL 


0600 


TASK 


0362 


TOFF 
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This program generates tapes with a modified Intel format. A typical 
record is shown in Figure 9.1. 

— — record header (colon 

I — record length (2 characters) 

I — address (4 characters) 

r— record type 00 or 01 ■ 

I data bytes 1 checksum (2 characters) 

I I I 

: 10010000C37D01DB10E601CA0301DB11E67FC9F5FF 

Figure 9.1. The hex tape format. 

In this example, the record length is 10 hex, the address is 100 hex, the 
record type is 00, the first data byte is C3, the last data byte is F5 hex, and 
the checksum is FF hex. This is the format used by the CP/M assemblers 
ASM and MAC to generate HEX files. 

Each record starts with a colon and is followed by the hex-encoded 
data. Since the data are encoded in ASCII, two bytes on the tape are needed 
to represent each original byte. Two hex characters, representing the record 
length, follow the header character. This hex value gives the actual number 
of data bytes contained in the record. It does not include the other characters 
in the record which designate the record address, the record type, and the 
checksum. A zero value for the record length is used for the last record to 
indicate the end of the file. 

The record address, the address of the first byte in the record, comes 
next. This address is encoded into four hex characters, high-order byte first. 
The next item is the record type; it consists of two characters and can be 00 
or 01. The value is usually 00, however; 01 is used for the end-of-file record 
for autostart tapes. 

The data from memory are encoded next. Two bytes on the tape repre- 
sent each data byte. The checksum byte is the last item in the record. It is 
formed by taking the two's complement of the sum of all the previous bytes 
in the record (in binary form). A carriage return, line feed, and optional 
nulls follow the checksum. 

When the hex tape is loaded into the computer, the bytes within each 
record including the checksum are added together. The checksum byte is 
formed from the two's complement of the original sum. Since the sum of a 
number and its two's complement is zero, the total at this point should be 
zero. A nonzero result indicates an error. 

The last record in the file has a record length of zero. This end-of-file 
record can indicate an autostart address in place of the usual record address. 
The computer can branch to this autostart address after the program is 
loaded. The record type in this case is 01— the end-of-file record. 
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Since the tape is written with an ASCII-encoded format, it is easy to 
read. Listing 9.2 shows the first part of the monitor made with the monitor 
itself. 

Listina 9.2 A hew dump of the heainnina of the monitor. 

t 10010000C37D01DBiOE601CA0301DBl 1EA7FC9F5FF 
n0011000DEflOE602CA1001FlD311C94CCD200i4DOC 
I10012000791F1F1F1FCC290179E60FC69027CE40EA 
:i001300027C30F01D630D8FE173Fn8FE0A3FD0D6CE 

The disadvantage of this format is that the tape takes twice as long to 
make and twice as long to read as a corresponding binary tape. A BASIC 
interpreter that loads in 20 minutes from a binary format would take 40 
minutes to load from hex format. 

You may want to reassemble the hex tape routine for some other 
memory location, or you may want to incorporate it into your system 
monitor. But wait until you've learned about the binary tape monitor shown 
later in this chapter before you do. 

Type in the hex program, assemble it, and start it up by branching to the 
beginning. A list of commands will be printed as a guide to operation. 

Hex paper-tape program: 

E load and execute 

G go to address given 

R read tape into memory (with optional offset) 

V verify tape against memory 

W vi^rite and label paper tape (with optional autostart) 

Console input is buffered just as it is in our system monitor. In fact, you will 
notice that many of the monitor I/O routines have been duplicated in this 
tape program. To create a tape, type the letter W (for write), the start 
address, and an optional autostart address. Finish the line with a carriage 
return. Typing errors can be corrected as usual with a DEL or backspace 
key. When the statement "Enter leader message" appears, either type the 
characters that you want on the tape leader, or just type a carriage return to 
skip the title. 

After the tape has been made, it should be verified. Type the letter V 
and a carriage return. If you have a Teletype with an automatic tape reader, 
the computer can turn it on at the beginning and turn it off at the end. This 
is accomplished by sending a control-Q at the beginning and a control-S at 
the end. Each entry on the tape will be compared to the corresponding value 
in memory. If a checksum or verify error is detected, the process will be 
terminated. The appropriate error message and the address of the error will 
appear. In the case of a checksum error, the address is not meaningful. 

A tape can be loaded into memory by typing the letter R (for read) and 
the optional offset value. This offset is added to the record address, after the 
record address has been added into the checksum. An offset of 1000 hex will 
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load a program 4K bytes higher than the regular address. An offset of FOOO 
hex will load the program 4K bytes lower. If you want, the computer will 
branch to the autostart address after the tape has been loaded; simply type 
an E (for execute) rather than an R. 

If a leader message has been punched on the tape, it is not necessary to 
position the tape past this message. The loader routine is looking for a colon 
to indicate the start of a record. But the colon symbol will never appear in 
the label itself. There is a GO command so that you can easily leave the tape 
program. Type the letter G (GO) and the address. 



A TAPE-LABELING ROUTINE 

The assembly language instructions that punch readable labels on paper tape 
begin at LABEL and continue on down to TABL. The data used by this por- 
tion starts at TABL and goes down to TASK. The characters that are avail- 
able include the complete set of ASCII characters from the blank (20 hex) 
through the underline (5F hex). The uppercase letters are included but the 
lowercase letters are not. One line of data in the source program is used for 
each character punched on the tape. The characters can be identified by the 
comment at the end of the line. The lines of data are arranged in sequence 
corresponding to the ASCII character set. The characters punched on the 
tape are generated in a five-by-eight matrix, with a row of blanks between 
the characters. 

When the label subroutine is called, it first prints a message requesting 
input. In response, the user enters one line of characters and concludes the 
line with a carriage return. The message is then punched on the tape. Each 
ASCII character is obtained from the console input buffer as needed. The 
ASCII character is converted to binary by subtraction of an ASCII blank. 
The result is then used as a pointer to find the corresponding entry in the 
table. This is done by multiplying the binary value by 5 and adding it to the 
table address. The next five bytes of the table are then Sent to the punch. 
The complete set of characters is shown in Figure 9.2. 




Figure 9.2. The set of letters and numbers produced by HEXMON. 
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The label subroutine with its necessary I/O routines can be removed 
from the tape program and used separately. It can be placed into high mem- 
ory and called by another program such as a BASIC interpreter. 



A BINARY TAPE MONITOR 



The hexadecimal program given in the previous section is useful for paper 
tape. But a binary tape routine is much more suitable for magnetic tape. 
With a magnetic tape format, the tape cannot be visually inspected. There- 
fore, there is no advantage in coding the data in hexadecimal format. 

Files are organized into records just as they are with the hex program. 
Each record starts with a record header, then continues with the record 
length, the address, the data, and the checksum. But the binary format is a 
bit different. As shown in Figure 9.3, there are three types of records: a 
header record, a data record, and an end-of-file record. The first record in 
the file is the file-header record. It begins with a 55-hex character. An 
optional filename appears next. The record header ends with a carriage- 
return character. 



Header Record 



55H 



Filename 



Carriage Return 



Data Record 



3CH 


Rec. Len. 


Addr. 


Data 


Checksum 



EOF Record 



74H 



Autostart Addr. 



Checksum 



Figure 9.3. Three different record types are used with the binary tape 
format: A header record, one or more data records, and an 
end-of-file record. 



The data record foUows the header record. It starts with a 3C-hex 
header byte, a record-length byte, and two bytes giving the record address. 
The record address is written with the low-order byte first. The data bytes 
appear next, and then the checksum concludes the record. 

With this format, the checksum byte consists of the sum of the data 
record bytes rather than the two's complement of the sum as used with the 
hex format. This checksum includes the record address and the data bytes, 
but it does not include the record length. The record length is not needed, 
since an incorrectly read record length will point to an incorrect byte that is 
to be used for the checksum. 

The end-of-file record is four bytes long. It begins with a 74-hex char- 
acter. It is followed by the autostart address, written as low byte, high byte. 
The fourth byte in this record is the checksum of the two-byte autostart 
address. 

The routine given in Listing 9.3 is not a complete program. It is meant 
to be added to the end of the system monitor developed in Chapter 6. The 
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I/O and conversion routines of the monitor are used whenever possible. If 
you want to use it as a stand-alone program, you will have to include the 
necessary I/O routines. The addition of the tape program to the monitor will 
increase its size to one-and-a-half K bytes. 

Add the new instructions to the end of the monitor, then change the 
monitor command-branch table for the letter T (tape) 

DW TAPE 5T 

SO that a command line starting with the letter T will cause a branch to the 
new tape routines. 



Listing 9.3. Binary tape routines. 



> LOCATIONS IN THE STACK AREA 



57C6 


= 


FBUF 


equ 


IBUFF+32 


? FILENAME BUFF 


57E6 




OFSET 


EQU 


FBUF+20H 


fLOAD OFFSET 


57E8 


= 


TASK 


EQU 


OFSET+2 




57E9 




LFLAG 


EQU 


TASK+1 


pLoad-error flag 


0055 




} 

SBYTE 


EQU 


55H 


J SYNC BYTE 


003C 




RHEAD 


EQU 


3CH 


5 RECORD HEADER 


0074 




EOF 

5 


EQU 


74H 


$END OF FILE 


0006 




PSTAT 


EQU 


6 


5 PUNCH STATUS 


0007 




PDATA 


EQU 


PSTAT+1 


» PUNCH DATA 


0001 




PIMSK 


EQU 


1 


? INPUT MASK 


0080 




POMSK 

9 


EQU 


80H 


» OUTPUT MASK 


5BFA 


210000 


i 

tape: 


LXI 


HjO 




SBFD 


22E657 




SHLD 


OFSET 


5 ZERO OFFSET 


5C00 


CD2559 




CALL 


GETCH 


; COMMAND 






r 

f tape 


-COMMAND 


PROCESSOR 




5C03 


FE45 


f 


CPI 


'E' 




5C05 


CAD25C 




JZ 


TLOAD 


sLOAD AND EXEC 


5C08 


FE4C 




CPI 


'L' 




5C0A 


CAD25C 




JZ 


TLOAD 


f LOAD 


5C0D 


FE4D 




CPI 


'M' 




5C0F 


CA805D 




JZ 


TMAKE 


?MAKE TEST TAPE 


5C12 


FE4F 




CPI 


'0' 




5C14 


CACA5C 




JZ 


OFFST 


> OFFSET LOAD 


5C17 


FE54 




CPI 


'T' 




5C19 


CA9A5D 




JZ 


TTEST 


>TAPE TEST 


5C1C 


FE5A 




CPI 


'M' 




5C1E 


CAD25C 




JZ 


TLOAD 


p VERIFY TAPE/MEM 


5C21 


FE44 




CPI 


'B' 


J DUMP TO TAPE 


5C23 


C2D459 




JNZ 


ERROR 
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f DUMP MEMORY TO TAPE IN 8~BIT BINARY FORMAT 
f 



5C26 


CD8659 




CALL 


RDHLDE 


; ADDRESS LIMITS 


5C29 


E5 




PUSH 


H 


f START ADDR 


5C2A 


CD9D59 




CALL 


READHL 


f AUTOSTART 


5C2D 


E3 




XTHL 




> SWITCH WITH Hfl 


5C2E 


CD885C 




CALL 


LEADR 


f TAPE LEADER 


5C31 


3E55 




MVI 


Af SBYTE 


5 SYNC BYTE 


5C33 


CD935C 




CALL 


TOUT 




5C36 


CD2559 


TDMP; 


CALL 


OETCH 


p FILE-NAME CHAR 


5C39 


DA425C 




JC 


PD4 


^FILENAME END 


5C3C 


Cri935C 




CALL 


TOUT 


J SEND TO TAPE 


5C3F 


C3365C 




JMP 


TDMP 


5 NEXT CHAR 


5C42 


3E0D 


PD4 5 


MVI 


A»CR 




5C44 


CD935C; 




CALL 


TOUT 


?PUT CR ON TAPE 


5C47 


3E3C 


PDO; 


MVI 


AIRHEAD 


5 RECORD HEADER 


5C49 


CD935C 




CALL 


TOUT 


jPUT ON TAPE 


5C4C 


7B 




MOV 


ArE 




5C4D 


95 




SUB 


L 




5C4E 


3C 




INR 


A 


f RECORD LENGTH 


5C4F 


4F 




MOM 


CrA 




5C50 


CD935C 




CALL 


TOUT 


fPUT ON TAPE 




7D 




Mnu 
nu V 


A a 1 

H f L. 




5C54 


CD935C 




CALL 


TOUT 


fL TO TAPE 


5C57 












5C58 


7C 




MOV 


AfH 




5C59 


Cn935C 




CALL 


TOUT 


m TO TAPE 


5C5C 


7E 


PDi: 


MOV 


Af M 


;get data 


5C5D 


CD935C 




CALL 


TOUT 


fSEND TO TAPE 


5C60 


OD 




DCR 


C 


1 RECORD COUNT 


5C6i 


CAA85C 




JZ 


PD2 


pDONE 


5C64 


23 




INX 


H 


$BUMP POINTER 




vJ 1./ W 1./ w 




IMP 


pni 


9 IyCI A 1 1 1 C. 






f 


ur f\tuurvl« 






5C68 


78 


PD2J 


MOV 


ftfB 


J GET CHECKSUM 


5C69 


CD935C 




CALL 


TOUT 


f SEND IT 


5CAC 


7C 




MOV 


ArH 




5C6D 


BA 




CMP 


D 


»END OF FILE? 


5C<6E 


CA755C 




JZ 


pn3 


?YES 


5C71 


23 




INX 


H 




5C72 


C3475C 




JMP 


PDO 


$NEXT RECORD 






t 

f END 

} 


OF FILE 






5C75 


3E74 


PD3S 


MVI 


AfEOF 




5C77 


CD935C 




CALL 


TOUT 


;SEND IT 


5C7A 


El 




POP 


H 


pAUTOSTART ADDR 


5C7B 


7D 




MOV 


AfL 


(LOW 


5C7C 


CD935C 




CALL 


TOUT 


fSEND IT 


5C7F 


45 




MOV 


B^L 


J START CHECKSUM 


5C80 


7C 




MOV 


ArH 


miGH 


5C81 


CD935C 




CALL 


TOUT 


5 SEND IT 


5C84 


78 




MOV 


ArB 


5 CHECKSUM 


5C85 


CD935C 




CALL 


TOUT 


5 SEND IT 
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MAKE A LEABER/TRAILER ON TAPE 



5C88 


AF 


leabr; 


XRA 


A 


»GET A NULL 


5C89 


0648 




MVI 


Bf72 


5 ft OF NULLS 


w w w 


JL* y vJ iJ W 


NLDR : 


CALL 


TOUT 


>SFND NULL 


5C8E 


05 




DCR 


B 




5C8F 


C28B5C 




JNZ 


NLDR 




5C92 


C9 




RET 










7 

» OUTPUT BYTE TO TAPE, 


ADfl TO rHFrK<nnM 


5C93 


F5 


tout: 


PUSH 


PSW 




5C94 


80 




ADD 


B 


>T0 CHECKSUM 


5C95 


47 




MOV 


B;A 


pPUT BACK 


5C96 


Fl 




POP 


PSW 




5C97 


F5 


pout; 


PUSH 


PSW 




5C98 


IIB06 


poutwj 


IN 


PSTAT 


5 STATUS 


5C9A 


E680 




ANI 


POMSK 








i NEXT 


LINE MAY 


NEED TO 










JNZ 


POUTW 




5C9F 


Fl 




POP 


PSW 




5CA0 


D307 




OUT 


PDATA 


rSEND BYTE 


5CA2 


C9 




RET 










1 INPUT BYTE FROM TAPE 








; ADD 


TO CHECKSUM 




5CA3 


CDB25C 


5 

TIN4! 


CALL 


PIN 


JGET BYTE 


5CA6 


F5 




PUSH 


PSW 




5CA7 


80 




ADD 


B 


?ADD TO CHECKSUM 


5CA8 


47 




MOV 


BoA 


SPUT BACK 


5CA9 


Fl 




POP 


PSW 








J 

; SEND 


TO CONSOLE IF NOT A CONROL CHARACTER 


"Sir A A 


C.O / r 


5 


ANI 


7FH 






r si^v 




CP I 






5CAE 


B8 




RC 




j CONTROL 


5CAF 


D311 




OUT 


CDATA 




5CB1 


C9 




RET 






5CB2 


DB06 


PIN! 


IN 


PSTAT 


» STATUS 


5CB4 


E601 




ANI 


PIMSK 








> NEXT 


LINE MAY 


NEED TO 


BE JZ PIN 


5CB6 


C2B25C 




JNZ 


PIN 


f NOT READY 


5CB9 


DB07 




IN 


PDATA 


JGET BYTE 


5CBB 


C9 


O 


RET 




;KEEP 8 BITS 



f LOOK FOR HEADER ON PAPER TAPE 
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5CBC 3E11 
5CBE CD975C 
5CC1 CDB25C 
5CC4 FE55 
5CC6 C2C15C 
5CC9 C9 



5CCA 57 
5CCB CD9D59 
5CCE 22E657 
5CD1 7A 



PIN4J 
PIN5{ 



MVI 

CALL 

CALL 

CP I 

JNZ 

RET 



AfCTRQ i-^Q 

POUT f TURN ON READER 

PIN >GET BYTE 

SBYTE fSYNC BYTE? 

P1N5 fNOf TRY AGAIN 



; LOAD A TAPE WITH 16-BIT OFFEST 



offst: Hoy 

CALL 
SHLD 
MOV 



OrA 5 SAME TASK 

READHL J GET OFFSET 

OFSET f SAVE IT 

A»D fRESTORE TASK 



LOAD/ VERIFY BINARY TAPE 



5CD2 
5CD5 
5CD8 
5CD9 
5CDC 
5CDF 
5CE2 
5CE3 
5CE4 
5CE7 
5CE9 
5CEC 
5CEF 
5CF2 
5CF3 
5CF5 
5CF8 



32E857 
21C657 
AF 

32E957 

CD2559 

DAE75C 

77 

23 

C30C5C 

3E0D 

32A657 

CDBC5C 

21C657 

7E 

FEOn 

CA1C5D 

11A657 



tload; 



TLDi: 



TLD55 



STA 
LXI 
XRA 
STA 

JC 

MOV 

INX 

JMP 

MVI 

STA 

CALL 

LXI 

MOV 

CPI 

JZ 

LXI 



TASK 

HfFBUF 

A 

LFLAG 
GETCH 
TLD5 

M?A 
H 

TLDl 

ApCR 

IBUFF 

PIN4 

HfFBUF 

A;M 

CR 

TLO 

Df IBUFF 



jsave command 

^filename buffer 
pGET a zero 
.reset flag 

5read filename 

fEND OF FILENAME 
IPUT IN FBUF 

f NEXT CHARACTER 



?FIND HEADER 
{FILENAME BUFFER 
»1ST CHARACTER 

pNO FILENAME 
» INPUT BUFFER 



INPUT FILENAME FROM TAPE? PUT IN IBUF 



5CFB 


CDA35C 


TLD2J CALL 


TIN4 


IBYTE FROM TAPE 


5CFE 


12 


STAX 


D 


IPUT IN IBUFF 


5CFF 


13 


INX 


D 




5D00 


FEOD 


CPI 


CR 




5D02 


CA125D 


JZ 


TLD4 


fNO FILENEME 


5D05 


BE 


CMP 


M 


pComp filenames 


5D06 


23 


INX 


H 




5D07 


CAFB5C 


JZ 


TLD2 


f NEXT CHARACTER 






) FILENAME ENTERED FROM 


CONSOLE 






i DOESN'T MATCH 


NAME ON 


TAPE 


5D0A 


3E4A 


> 

MVI 


A? 'F' 


fSET ERROR FLAG 


5D0C 


32E957 


STA 


LFLAG 




5D0F 


C3FB5C 


JMP 


TLD2 




5D12 


AF 


TLD4I XRA 


A 




5D13 


IB 


DCX 







5D14 


12 


STAX 


D 




5D15 


3AE957 


LDA 


LFLAG 


? CHECK FLAG 


SD18 


B7 


ORA 


A 


IZERO? 


5D19 


C2C05D 


JNZ 


FNERR 


5FILENAME ERROR 
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5D1C 


CDA35C 


TLOJ 


CALL 


TIN4 


5BYTE FROM TAPE 


5D1F 


FE74 




CPI 


EOF 




5D21 


CA605n 




JZ 


EXEC 


rOONE 


5D24 


FE3C 




CPI 


RHEAD 


$ RECORD HEADER 


5D26 


C21C50 




JNZ 


TLO 


fTRY AGAIN 


5D29 


CDA35C 




CALL 


TIN4 


? RECORD LENGTH 


5D2C 


4F 




Moy 


CvA 


jPUT IN C 


SD2D 


C0A3SC 




CALL 


TIN4 


?ADDRi> LOW BYTE 


5030 


5F 




Moy 


E ? A 


* T ki Tr#^ IT" 

f INTO E 


503 1 


47 






B r A 


rPUT IN CHECKSUM 




ri A cc r* 




CALL 


TIN4 


r ADDRf HIGH BY 1 E 


5035 


57 




MOM 


DjA 


f INTO D 


5D36 


2AE657 




LHLO 


OFSET 


i GET LOAD OFFSET 


5D3V 


19 




OAD 





f ADD TO ADDRESS 


503A 


3AE857 




LOA 


TASK 


J GET TASK 


5D3D 


57 




Moy 


Or A 


5PUT IN 


5D3E 


CDA35C 


TLl t 


CALL 


TIN4 


J DATA BYTE 


5D41 


5F 




MOV 


E»A 


5 SAVE IN E 


5D42 


7A 




MOV 


Af 


» CHECK THE TASK 


5D43 


FE56 




CPI 


'V 


> VERIFYING? 


5045 


7B 




MOV 


Af E 


f GET BYTE AGAIN 


5046 


CA4A5D 




JZ 


SKIP 


>VERIFYING» SKIP 


5049 


77 




MOV 


M>A 


f INTO MEMORY 


5D4A 


BE 


SKIP J 


CMP 


M 


5 IS IT THERE? 


5D4B 


C2AE50 




JNZ 


PERROR 


im 


5D4E 


23 




INX 


H 


;INCR ADDRESS 


504F 


00 




OCR 


C 


; RECORD COUNT 


5D50 


C23E5D 




JNZ 


TLl 


rNEXT BYTE 






s 

f END 


OF RECORD 


f GET CHECKSUM 


5053 


48 


S 


MOV 


CfB 


f CHECKSUM TO C 


5D54 


CDA35C 




CALL 


TIN4 


f TAPE CHECKSUM 


5057 


09 




CMP 


C 


f THE SAME? 


5058 


CA1C50 




J2 


TLO 


?YES 


5D5B 


3E43 


cserr: 


MVI 


Af 'C 


; ERROR 


5D5D 


C3455A 




JMP 


ERR2 





I END OF TAPE? GET AUTOSTART ADDRESS 
} SEE IF EXECUTING 



5D60 


CDA35C 


exec: 


CALL 


TIN4 


f START? LOU 


5D63 


6F 




MOV 


LfA 


fPUT IN L 


5D64 


47 




MOV 


B>A 


; START CHECKSUM 


5065 


CDA35C 




CALL 


TIN4 


; START. HIGH 


5D68 


67 




MOV 


H?A 


fPUT IN H 


5069 


48 




MOV 


CfB 


fGET SUM 


5D6A 


CDA35C 




CALL 


TIN4 


fREAD CHECKSUM 


5D6D 


B9 




CMP 


C 


$SAME 


506E 


C25B5D 




JNZ 


CSERR 


;N0 


5071 


C0B45D 




CALL 


POFF 


; READER OFF 


5074 


7A 




MOV 


ArO 


1 CHECK TASK 


5075 


FE45 




CPI 


'E' 


5 EXECUTING? 


5077 


CA7F5D 




JZ 


PCHLT 


5 YES 


5D7A 


3E45 




MVI 


Af 'E' 


5 EXEC ADDRESS 


5D7C 


C3455A 




JMP 


ERR2 
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i THE NEXT LABEL CAN BE PLACED AFTER 

5 THE LABEL CALLS/GO NEAR THE BEGINNING 



5X17F 


E9 


pchlt: 


PCHL 










> 

f MAKE 


BINARY 


TEST TAPE 


p EACH BYTE 






» IS ONE LARGER THAN PREVIOUS BYTE 






* 1 1 T TO 

f Ul 1 1 H 


OVERFLOW r 00 IS 


Ar 1 C.K r r 


5D80 


21F401 


f 

tmake: 


LXI 


Hp 500 


pABORT CHECK 


cr i"i cj 


A 

/A 


T M A k-' O * 


MOV 


ftfD 


* C** Tf" A "Pi V T* 

p ot 1 A CT 1 1 


5D84 


iTi r> T 




CALL 


TOUT 


p otNU 1 1 Art 


5D87 


14 




INR 





± T Mf^DC"MC" &BT TT 


5088 


2B 




OCX 


H 


p UcLK LUUN a 


5D89 


7C 




MOV 


ApH 




5D8A 


B5 




ORA 


L 




5B8B 


C2835D 




JNZ 


TMAK2 


ft ejn 
P NU 


5D8E 


CD2558 




CALL 


INSTAT 


*TltrC»!wITMATTri)il'J> 

p Tt KM I NAT ION 7 


5D91 


CA805D 




JZ 


TMAKE 


pNO 


5D94 


CD 1558 




CALL 


INPUTT 


f"X FOR ABORT 


5D97 


C38050 




JMP 


TMAKE 


pNO 








BINARY 


TEST TAPE 








; EACH 


BYTE MUST BE ONE 


LARGER 






> THAN 


THE PREVIOUS ONE 








ttestj 


CALL 


PIN 


pGet a byte 


5090 


57 




MOV 


Dp A 


pSave it 


5D9E 


CnB25C 


TTpcjT'3 • 


CALL 


PIN 


pNExt byte 


5DA1 


14 




INR 


D 


p INCR FIRST 


5DA2 


BA 




CMP 


D 


J SAME? 


c; ri A -7 


p A o c" n 




JZ 


TTEST2 


p YES 


5D A6 






MVI 


As 'C 


pNO 


5DA8 


CD2A58 




CALL 


OUTT 


pC for error 


5DAB 


C39A5D 




JMP 


TTEST 


pSTart again 






f 

} TAPE 


ERRORS' 


PRINT B AND ADDRESS 


5DAE 


CDB45D 


perror: 


CALL 


POFF 




5DB1 


C3435A 




JMP 


ERRB 








5 TURN 


OFF TAPE READER 




5DB4 


3E13 


POFFt 


MVI 


ApCTRS 


p READER OFF 


5DB6 


C3935C 




JMP 


TOUT 





p 

p filename errorp print actual 

p FILENAME ON TAPE 



5DB9 


205472793AEMESS: 


DB 


' Tr«S ' 


pO 


5DC0 


CDB45D 


FNERR : 


CALL 


POFF 


p READER ON 


5nC3 


11B95D 




LXI 


DpEMESS 


p ERROR MESSAGE 


5DC6 


CD3B59 




CALL 


SENDM 


pSEno it 


5DC9 


11A657 




LXI 


Dp IBUFF 


pFile name 


5DCC 


C33B59 




JMP 


SENDM 


pSend it too 


5DCF 




p 


END 
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Snnbols : 



5B07 


A0MP2 


5B23 


ADMP3 


5AED 


AL0D2 


r~ B~ B~ ~» 

FFF7 


APOS 


0008 


BACKUP 


5B4C 


BIT2 


0011 


CDATA 


001 1 


CBATAO 


5858 


COLD 


5806 


COiJT 


590F 


CRLF 


5D5B 


CSERR 


0008 


r* T r« ui 
1, 1 KH 


001 1 


CTRQ 


OO/r 


UtL 


5945 


HUMP 


595E 


DUMP4 


5967 


fit 1 U n C 

nUnPS 


C A C 






ERRB 


rtrt -S IS 

00 1 K 




5K60 


k.Ak.L/ 


C A Z Z 
□ HOO 


C T 1 i O 

r XLL<: 


a=! A z r* 




joOr 


uLHhK 




bt 1 L4 


.j Vr D 






HnLisfc. 




tLJ}i4 ATU 

HriM 1 H 


57A5 


i £iUr L 


OODB 


INC 


580C 


INLN 


58F1 


INPL3 


5919 


INPLB 


58DD 


INPLI 


58D0 


INPLN 


5825 


INSTAT 


5B3D 


I PORT 


5B89 


JUST2 


5B92 


JUST3 


57E9 


LFLAG 


5A0D 


LOAD 


5A30 


L0AD4 


5A37 


L0AD6 


5AA0 




5878 


MSIZE 


586A 


NPAGE 


5CCA 


OFFST 


5B5A 


OPORT 


5800 


0R6IN 


j£>44 


Uu 1 4 


UOOj 


UU 1 L 


59DF 


UUTHL 


59EC 


OUTHX 


582A 


OU I 1 


5981 


F'ASC2 


)^ ri "7 cr 


s"! LS fl T 

r LHL 1 


5C47 


fc> ri 
r DO 


5C75 


PD3 


5C42 


PD4 


0001 


a*"i 1" ij( e.-" 

PliiSK 


5CB2 


P I N 


5DB4 


F'OFF 


0080 


POiiSK 


5C98 


POUTW 


0006 


PSTAT 


59B7 


RDHL4 


59C1 


RDHL5 


599D 


READHL 


5A4E 


REGS 


5BCC 


REPL3 


5803 


RESTRT 


0055 


SBYTE 


5AAD 


SEAR2 


5AC9 


SEARS 


5AAA 


SEARCH 


5D4A 


SKIP 


57A0 


STACK 


589C 


TABLE 


5BFA 


TAPE 


5CA3 


TIN4 


5D1C 


TLO 


5CFB 


TLD2 


5D12 


TLD4 


51183 


TMAK2 


5D80 


THAKE 


5A00 


TSTOP 


5D9A 


TTEST 


5BD5 


VERH2 


5BF3 


VERM3 


5A55 


ZERO 







5B26 


ADnP4 


5B04 


A T*l t 1 biS IT* 


5AD5 


ASCI I 


5B2C 


ASCS 


5B4A 


BITS 


5A09 


CALLS 


5A3E 


CHE KM 


5809 


CIN 


GOOD 


CR 


59DC 


CRHL 


0010 


CSTAT 


0010 


CSTATO 


001.3 


L 1 Kb 


UO 1 o 


L 1 Ka 


KO AC3 


Tit IMC^'t 


□ 940 




5DB9 




00/4 


tUr 






D«4ji: 




O/Lo 


r t>Ur 




r 


Kr A-yer 

DH / ^J 


cr T 1 1 
r iLLH 




r WC.I\r\ 




UC. 1 trfl 


E! A AO 


uU 




LSI riCRP 


IS! AO A 




57A6 


IBUFF 


57A3 


1 £tur r 


0001 


I NMSK 


58EiS 


INPL2 


5901 


INPLC 


58FB 


INPLE 


581B 


INPUT2 


5815 


INPUTT 


5BA5 


JERR 


5B85 


JUST 


5C88 


LEADR 


OOOA 


LF 


5A10 


L0AD2 


5A33 


L0AD3 


5A96 


MOVDN 


5A93 


MOVE 


59C4 


NIB 


5C8B 


NLDR 


57E6 


OFSET 


0002 


OMSK 


582B 


0UT2 


5839 


UU 1 O 


SCO "1 1 


uu 1 H 


JTt4 


UU 1 nfc.A 


59E3 


OUTLL 




ni B TOD 

UU i or 


5983 


PASC3 


39/0 


D A e r* T 




r 11 1 






0007 


PDATA 


5DAE 


ic ti c« n C" 


5CBC 


PIN4 


5CC1 


PIN5 


57A0 


PORTN 


5C97 


POUT 


5B63 


PUTIO 


59A2 


RDHL2 


5989 


RDHLB2 


5986 


RDHLDE 


5BB4 


REPL 


5BC1 


REPL2 


00C9 


RETC 


003C 


RHEAD 


SABS 


SEAR3 


5ACF 


SEAR4 


593B 


SENDM 


584F 


SIGNON 


5800 


START 


0009 


TAB 


57E8 


TASK 


5C36 


TDMP 


5n3E 


TLl 


5CDC 


TLDl 


5CE7 


TLD5 


5CD2 


TLOAD 


0018 


TOP 


5C93 


TOUT 


5D9E 


TTEST2 


5BD2 


VERM 


3831 


MERS 


5861 


UARM 
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There are seven tape commands that can be given. The appropriate 
command letter must immediately follow the letter T. The first thing that 
should be done is to make a test tape. In fact, the test pattern should be 
recorded onto the beginning of each tape you own. Give the command 

>TM 

(tape make), and start recording. The computer will send a sequence of 
bytes, each being one larger than the previous one. When the maximum 
value of FF hex has been sent, the next byte will be a zero. Record the pat- 
tern for 15 to 30 seconds. Type a control-X to end the procedure. 

The integrity of the whole tape-recording system can now be tested. 
Rewind the test section of the tape and play it back. Type a command of 

.>TT 

(tape test). The computer will read a byte from the tape, increment the 
value, then read another byte. If the two values don't agree, then a letter C 
will be printed on the console. The process will then be repeated until you 
terminate it. 

If the two values do agree, then the computer will increment the first 
byte again, read another byte, and compare the two. This process will be 
repeated over and over. Each byte on the tape will be compared to see that 
it is exactly one larger than the previous byte. If you can go through a one- 
hour cassette recording without a single error, then you have a reliable 
system. 

You may have an adjustment on the A/D converter circuit that allows 
you to set the frequency of the phase-locked loop (PPL). The MITS audio 
cassette boards have this feature. Make a test tape at least 10 minutes long, 
then play it back. Adjust the PPL frequency until a stream of Cs appear on 
the console; then adjust the PPL frequency in the opposite direction. The Cs 
should not print. Continue adjusting the PPL in the opposite direction again 
until the Cs appear again. You have now bracketed the usable range of the 
PPL. Set the PPL adjustment halfway between these two extremes. 

There are some other tests you can make while the test tape is playing. 
Try moving both the audio cables and the AC line cords around to see if 
certain positions will cause an error. You can also try tapping the tape 
recorder, the computer case, the boards in the computer, and so on to see 
how delicate the system is. Pretty soon you will know if you have a reliable 
tape storage system. Remember to run the test tape at least once a week. 

To save data from the computer's memory, including the tape program 
itself, type 

>TD<st3rt> <stop> <3utost3rt> <filen3iiie> 

After the D (for dump), give the start address, the stop address, the required 
autostart address, and an optional filename. A filename is important on 
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magnetic tape to ensure that you are loading the right program. The auto- 
start address can be the system monitor address. CP/M programs can be 
saved on tape using the original filename. Load the program into memory 
with DDT, SID, or the program FETCH given in the next chapter. Branch to 
the tape program and give the command 

>TD100 9AF 100 TAPE. ASM 

The filename can include the decimal point and the file type. 

Each time a new tape is made, it should be verified with the command 

>TV<f ileri8ifie> 

A tape can be loaded into memory, at its normal position by typing 
>TL<f ilen3nie> 

At the conclusion of the load, the autostart address is printed on the con- 
sole then control returns to the monitor. If an incorrect filename is entered, 
the load operation is aborted and the actual filename on the tape is printed 
on the console. 

During the load operation, all printable characters are displayed on the 
console. If your console is a printer rather than a video console, you will 
have to remove this feature to prevent .the computer from falling behind. In 
this case, take out the following three lines from subroutine POUTW. 

CPI ' ' 

RC 

OUT CDATA 

It is not necessary to verify the load step because of the checksum feature. 
If the load step was completed, then the tape was correctly read into 
memory. 

The E command can be used instead of the L command for loading 
data. In this case the computer will branch to the autostart address at the 
completion of the load. A BASIC interpreter could be saved with the auto- 
start address set to the BASIC start address. BASIC will then automatically 
start up at the completion of the E load command. The O command is used 
to load a tape at an offset from its regular address. 

While this binary format is designed for magnetic tape systems, it can 
be used for paper tape as well. If a tape is punched on a Teletype machine, 
there will be a strange sound. The reason is that binary, rather than ASCII 
characters, are being punched. The printout will also be meaningless. But 
when the resulting tape is read back, the operation is quiet, since the inputted 
characters are not echoed back on the Teletype. 



CHAPTER TEN 

Linking Programs to the 
CP/M Operating System 



The system monitor we developed in Chapters 6 and 7 allows us to com- 
municate with the computer through the console. But this program only 
provides the bare minimum of operations such as memory display, block 
move, hex addition and subtraction, and so on. Computers are capable of 
performing more complicated tasks such as decimal arithmetic, keeping 
business records, formatting text, and game playing. Computer languages, 
such as FORTRAN, COBOL, and Pascal, make these tasks easier. These 
languages will operate on programs (called source programs) that are written 
by the user. 

As an example, a BASIC interpreter, which may be as large as 24K 
bytes, needs a user's source program for direction. An assembler needs a 
source file to generate the desired machine code. And, of course, a format- 
ting program needs a work file to produce a finished file. 

Because programs to perform these common tasks are so large, an 
efficient method of loading them into memory is needed. In addition, the 
output generated by these programs needs to be stored somewhere. Magnetic 
tape can be used for this purpose, but it tends to be slow. The floppy disk 
currently is a better medium. It is relatively inexpensive, and the recording 
medium, the diskette, can be removed. This means that backup copies can 
be easily generated. In addition, programs can be readily exchanged between 
users. 

We wrote our system monitor to transfer data between the console and 
the computer proper. Likewise, we need a disk-operating system (DOS) to 
effect an orderly transfer of information between the disk and the computer. 
Several different floppy disk systems are available for the 8080 and the Z-80. 
The disk-operating system that is provided with the disk drives may be 
relatively primitive, or it may be very elaborate. 

A very popular DOS available today for the 8080 and Z-80 is called 
CP/M. CP/M was initially developed for the 8080 S-100 buss and the 8-inch 
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soft-sectored floppy disk. It is now available for most of the other configu- 
rations, including the 5-inch floppies and the Winchester hard disk. Versions 
are supplied for computers that dpn't have an S-100 buss, such as the 
TRS-80. 

CP/M is a software system that must be interfaced to each different 
computer configuration through a set of software interface routines. Once 
the interfacing is accomplished, the computer programs that run with CP/M 
become system independent. 

The operating system integrates all of the common tasks. Before CP/M 
came along, each assembler and BASIC interpreter had to incorporate its 
own text editor. The user could then write and correct the source program 
with the built-in editor. But with the CP/M operating system, the editing can 
be performed separately from program execution. An independent system 
editor is used to create an ASCII source file. Then a processor program such 
as BASIC, FORTRAN, Pascal, an assembler, or a text-output formatter can 
be directed to utilize the source file. The results can be stored in a separate 
ASCII file on the disk. 

It is possible to generate an assembly-language program with the system 
editor, then assemble it as we did when we developed the system monitor in 
Chapters 6 and 7. In this case we had to tailor the console input and output 
routines to the host computer. In particular, we included in the program the 
address of the console status and data ports, and the read-ready and write- 
ready status bits. The sense of the status flags was selected with a JZ com- 
mand corresponding to an active-high flag. As a result of this approach, our 
system monitor is not portable. The monitor runs on your system, but it 
might not run on someone else's unless the I/O details are changed. 

We approached a solution to this problem in Chapter 8, where we wrote 
some base-conversion routines. We did not have to write the I/O subroutines 
into each program because we utilized the ones in the monitor. 

When we wrote the monitor, we placed five jump vectors at the begin- 
ning. These provided an easy access to the commonly used routines. While 
this technique greatly simpHfies things, it has the disadvantage that three 
bytes must be set aside for each different entry point. Also, the programmer 
must keep track of which entry is used for which task. • 

A better approach is to have only a single entry address for all opera- 
tions. When this special address is called by an external program, the values 
in the CPU registers indicate the desired operation and provide the data. The 
CP/M operating system utilizes this , approach. All of the systems operations 
are performed by calling memory address 5. Up to 37 different operations 
can be performed in this way. Operations 1 through 11 allow interaction 
with the four logical peripherals named CONSOLE, LIST, PUNCH, and 
READER. They are summarized in Table 10.1. Operation 12 allows a 
program to determine the current CP/M version. The remaining function 
numbers are used for disk operations such as reading, writing, and head 
positioning. 

The desired operation is selected by placing the proper function 
number into register C. Sixteen-bit data are transferred in the DE register. 
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Eight-bit data are transferred in Register E or the accumulator. For example, 
the console input status can be determined by placing the function number 
of 11 (decimal) in the C register, and calling address 5. 

MVI Cll 
CALL 5 



Table 10.1. CP/M I/O operations. The function number is placed into register C. Single 
bytes are in register E. Double bytes are in the D, E register pair. 



Function 








number 






Value 


(inC) 


Operation 


Value sent 


returned 


1 


read CONSOLE 




char in A 


2 


write CONSOLE 


char in E 




3 


read READER 




char in A 


4 


write PUNCH 


char in E 




5 


write LIST 


char in E 




6 


direct console I/O 


FF (input; 
char (output) 


char/stat in A 


7 


get I/O byte 




lOBYTE in A 


8 


set I/O byte 


lOBYTE in E 




9 


print CONSOLE buffer 


buffer address in D, E 




10 


read CONSOLE buffer 


buffer address in D, E 


characters in 
buffer: 


11 


CONSOLE status 




= not ready 



FF == ready 



On return, the accumulator and register E contain the value of FF hex if the 
console is ready for input, or a zero if not. The byte in the console data 
register can then be read by calling address 5 with the value of 1 in register 
C. The byte that is read will be returned in the accumulator. 



CP/M MEMORY ORGANIZATION 

When CP/M is in operation, the main memory is divided into several regions. 
In order of decreasing memory, they are : 

1. Basic Input/Output System (BIOS) 

2. Basic Disk-Operating System (BDOS) 

3. Console-Command Processor (CCP) 

4. Transient-Program Area (TPA) 

5. System parameter area 

If the BIOS is especially tailored to a particular system, then it is called the 
customized BIOS or CBIOS. The BIOS and BDOS regions are collectively 
known as the Full Disk-Operating System (FDOS). The memory layout is 
shown in Figure 10.1. 
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FDOS 



BIOS 



BDOS 
CCP 



TPA 

sastem parsmeters 



hiah memory 



100 hew 

Figure 10.1 A memory map for CP/M. 

BIOS contains the tailor-made routines for operation of all the periph- 
eral devices such as the console, printer, disk drives, phone modem, and tape 
drives. BDOS has the hardware-independent routines for the disk operating 
system. The CCP handles the console commands. It contains the built-in 
routines such as DIR, LIST, and ERA. Separate programs such as PIP, DDT, 
and user-written programs execute in the TPA. 

The lowest memory area contains several different items. The first is a 
warm-boot entry to BIOS. The first few entries are: 



Address 



Action 



Purpose 




3 
4 
5 

5C hex 



JMP BIOS+3 

lOBYTE 

disk 

JMP BDOS+6 
FCB 



warm start entry 
peripheral assignment 
current drive number 
peripheral control 
command-line argument 



CHANGING THE PERIPHERAL ASSIGNMENT 

CP/M can interact with four logical peripheral devices. These are termed: 

CON: console 

LST: list (printer) 

PUN: punch 

RDR: (tape) reader 

Each of these four logical devices can be assigned to four different physical 
devices. The 16 different possible combinations can all be encoded into the 
lOBYTE located at memory address 3. The colon is part of the name; it is 
used when referring to peripheral devices. Disk filenames, on the other hand, 
are written without the colon. 

The actual mapping of the logical devices into the desired physical 
devices must be accomplished in BIOS. Since there are so many different 
possibilities, it is not likely that the system supplied by your dealer will have 
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the lOBYTE features fully implemented. The CP/M logical console is prob- 
ably mapped into your video terminal and the logical list device will be 
mapped into your printer. But the punch and reader might be mapped into 
your video terminal. 

Even if you have only two peripherals, it may be useful to set up the 
lOBYTE feature. For example, suppose that you have both a video terminal 
and a printer such as a Decwriter or Teletype that has its own keyboard. 
Then either peripheral can be used for the console input and either can be 
used for the console output. The four physical console arrangements could 
correspond to: 

lOBYTE Input Output 

video video (default) 

1 video printer 

2 printer printer 

3 printer video 

Your customized BIOS (CBIOS) will set the default combination on a 
cold start. But any user program can change the lOBYTE to a new configu- 
ration. Also, the CP/M programs STAT and DDT can be used to alter the 
lOBYTE. The instructions in CBIOS will sample the lOBYTE and act 
accordingly. 

Suppose that the lOBYTE is set to zero, and you load a BASIC inter- 
preter. You develop a program that sends information to the console. The 
program will include statements like 

« « « 

PRINT If X<I)f Yd) 
♦ • » 

The resulting output appears on the console video screen. After the program 
is debugged, you would like a hard-copy output of the program results. This 
is easily done if you have incorporated the lOBYTE feature. You can change 
the lOBYTE with the POKE command in the BASIC interpreter. 

POKE 3f i 
RUN 

The POKE command will change the lOBYTE at address 3 from a zero to 
a 1. Console output will now appear at the printer when the BASIC program 
is run. Of course, console input has not changed; it still comes from the 
video terminal. At the conclusion of the run, the lOBYTE can be restored 
with another POKE command. 

POKE 3» 

As another example, suppose that you have a Teletype for your list 
device and it has a paper tape reader and punch. You can easily make BASIC 
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tapes and reload them using the lOBYTE features. POKE the lOBYTE to a 
value of 1 for punching a source tape. This will map the Teletype output 
into the logical console output. Give the BASIC commands 

NULL 3 
LIST 

to make a tape of the source program. 

Later, you can reload the tape into BASIC by setting the lOBYTE to a 
value of 3. 

POKE 3f 3 

Just put the tape into the reader and turn it on. With this configuration, the 
Teletype keyboard and tape reader perform the console input. But the video 
screen is used for console output. After the tape has been read, give the 
command 

POKE 3. 

from the Teletype keyboard to return to the console keyboarci. 



INCORPORATING THE lOBYTE INTO YOUR CBIOS 

You will have to reassemble your CBIOS if you want to incorporate the 
lOBYTE feature. A sample CBIOS that uses the lOBYTE is given in Listing 
5.1. This version additionally features such things as an interrupt-driven key- 
board and connection to a telephone modem. 

At the beginning of BIOS there are seven jump vectors that are used by 
other parts of CP/M. 



JHP 


INIT 


? initisl isation 


JMP 


CONST 


pconsole status 


JHP 


CONIN 


fconsole Infut 


JMP 


CONOUT 


Iconsole output 


JMP 


LOUT 


Hist output 


JMP 


PUNCH 


p punch 


JMP 


READR 


1 reader 



Because of these fixed entry points, BIOS can be altered without having to 
alter any other part of CP/M. There are four regions of BIOS that need to 
be changed if the lOBYTE feature is incorporated into console routines. 
These are the routines for initialization, console status, console input, and 
console output. We have to set the lOBYTE to the default value in the 
initialization section of BIOS. Then, at the beginning of the three console 
routines, we have to read the lOBYTE at address 3, and branch to the 
appropriate subroutine. 
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In accordance with the step-by-step approach to programming we used 
in Chapter 6, we will not make all the changes at one time. The first altera- 
tion will be to the initialization and output routines. 



Incorporating the lOBYTE into Output Routines 

First locate the initialization region of BIOS. This area is referenced by the 
first jump instruction at the beginning of BIOS. Add the following instruc- 
tions somewhere in the initialization routine. 

MVI AfO fSet a zero 

STA 3 JSET lOBYTE 

The safest places to put them are at the very beginning of the initialization 
section or at the end, just before the RET instruction. We could, of course, 
use an XRA A instruction rather than the MVI A,0 instruction shown above. 
This would reduce the size of BIOS by one byte. But if we later wanted 
BIOS to initialize the lOBYTE to 3 we would have to reassemble BIOS. 
With the MVI instruction, we can easily change the argument of zero to a 3 
by using the system debugger. 

Refer to the label START at the beginning of Listing 4.1 where there is 
a series of jump instructions. 



start; 

JMP 
JMP 
JMP 
JMP 



Locate the address of the console-output routine. This can be found from 
the fourth jump instruction, JMP CONOUT in this case. We will now alter 
the console-output routine so that it will read the lOBYTE at memory 
address 3 and act accordingly. The upper six bits, which refer to the list, 
punch, and reader, are reset by performing a masking AND with the value 
of 3. 

XXXX XXOl or XXXX XXIO lOBYTE 

11 11 AND with 3 



0000 0001 or 0000 0010 lOBYTE 

The two low-order bits then determine whether output is sent to the console 
or to the printer. If the resulting value is a 1 or a 2, then a branch is made to 
the printer-output routine. Otherwise, output goes to the video console. 
Printer output corresponds to the following lOBYTE bit patterns. 



INIT ^INITIALIZATION 

CONST » CONSOLE STATUS 

CONIN ^CONSOLE INPUT 

CONOUT » CONSOLE OUTPUT 
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0000 0001 or 0000 0010 lOBYTE 

11 11 AND with 3 

0000 0001 = 1 0000 0010 = 2 
The other two possible lOBYTE patterns correspond to console output. 

0000 0000 = or 0000 0011 = 3 

Notice that parity is odd for printer output but parity is even for console 
output. Thus the BIOS code at this point is programmed to jump to the 
list-output routine if parity is odd. 



r 

9 LOGICAL CONSOLE OUTPUT 
I 

CONOUTJ LDA lOBYTE I GET ASSIGNMENT 

ANI 3 (MASK FOR CONSOLE 

JPO LOUT JLIST OUTPUT 

f 

f VIDEO-OUTPUT ROUTINE 

VIDEO! . . » (existina routine) 



; LIST-OUTPUT ROUTINE 

LOUT ! • < . (existing routine ) 
♦ ♦ * 



Assemble the new BIOS and try it out. We can use the system debugger 
DDT or SID to load the new CBIOS over the old one. The command is 



A>DDT CBIOS. HEX 

One word of caution: Since the debugger uses the routines in CBIOS, there 
may be a problem. A safer way to put the new CBIOS into place is to first 
load it somewhere else. 

Use the hex arithmetic command of DDT to calculate the offset. Sup- 
pose that BIOS is assembled for the address DBOO hex and you want to load 
it temporarily at 100 hex. Then the command 

HlOO DBOO 

will give both the sum and difference of the two addresses. The difference is 
what we need. Load CBIOS with the indicated offset 

ICBIOS.HtX 
R(of f set) 
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DDT will indicate the location of the end of BIOS. The move command can 
now be used to put BIOS into its proper place. 

MlOO 2FF DBOO 

The second address will be the present end of BIOS. The new BIOS is now 
in place. If the debugger no longer works, there may be an error in BIOS or 
there may have been an error in the move command. 

If everything appears to be all right, try out the lOBYTE feature. Use 
the S (set) command of the debugger to change the lOBYTE at address 3. 
Change the value of the lOBYTE from a zero to a 1. 

S3 

0003 00 1 (tape a 1) 

0004 00 > itupe 3 decimal point) 

The (logical) console output should now appear at the printer instead of the 
console. Notice that this is different from typing a control-P when the 
lOBYTE has a value of zero. In fact, if a control-P is typed at this time, each 
typed character should be printed twice. Return the logical console output 
to the console by changing the lOBYTE back to zero using DDT. 

S3 

0003 01 (tape a 0) 

0004 00 . (tape a decimal point) 

Output should return to the console. 

If everything appears to be all right, you are still not finished. You have 
a working copy of BIOS in memory; now you must get a copy onto the sys- 
tem tracks of the disk. Continue with this section if you want to write a 
permanent copy of the new BIOS onto the disk. Otherwise, go on to the 
second part of the alteration where you will add the lOBYTE feature to the 
console input routines. Then come back to this section to save the com- 
pleted BIOS. If you have a Lifeboat version of CP/M, you can easily copy 
the new version of BIOS to the disk. Just give the command 

A>SAMEUSER 

and the new BIOS will be copied to the system disk. 

Another method of getting the new CBIOS on the disk system tracks 
is to use SYSGEN. The current version of CPM is loaded into memory with 
the DDT command 

A>DDT CPMXX.COM 

where XX refers to the memory size. Then move the working version of 
BIOS down to the proper SYSGEN position using the DDT move command. 
Alternately, the HEX file of CBIOS could be copied from disk into memory. 
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The SYSGEN location for BIOS should be given in your CP/M documenta- 
tion. Perform a warm start with a control-C, and then give the command 

A>SYSGEN 

Answer the first question about where to get the system by typing just a 
carriage return. The second question asks where to put the system. Give the 
appropriate drive name, A, B, etc. The new BIOS will now be copied to disk. 



Incorporating the lOBYTE into Input Routines. 

We are now ready to implement the second part of the console lOBYTE 
feature. This will allow the logical console input to be obtained from either 
of two keyboards. One of these keyboards will be the video terminal; the 
other will be the printer. If you don't have a second keyboard, go on to the 
next section. 

Locate the console status and the console input routines. These are 
found from the second and third entries of the jump table of BIOS. Your 
present console-input routine may be coded in one of two ways. One 
method is straight-forward. The input routine has a status check independent 
of the regular BIOS status routine. 

i CONSOLE INPUT ROUTINE 

> 

CONIN: IN CSTAT f GET STATUS 

AN I CIMSK »MASK FOR INPUT 

JZ CONIN JLOOP UNTIL READY 



The other method uses the BIOS status routine. 



t CONSOLE INPUT ROUTINE 

5 

conin: call const jget status 

JZ CONIN J loop until READY 



Although either method can be altered to include the lOBY TE feature, 
the former method will be demonstrated here. We will need two separate 
input routines. One is for the video screen and the other is for the printer or 
other keyboard. Our new console input routine might look like this. 

) logical console input 

9 

conin: lda iobyte jget assignment 

ANI 2 fMASK FOR LIST 

JNZ LISTIN 5LIST INPUT 
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INPUT 






IN 


CSTAT 


sGET STATUS 


AN I 


CIHSK 


IHASK FOR INPUT 


JZ 


VIDIN 


»LOOP UNTIL READY 


IN 


CDATA 


>GET DATA 


ANI 


7FH 


JMASK PARITY 


RET 






FROM 


PRINTER 




IN 


LSTAT 


(GET STATUS 


ANI 


LIMSK 


(MASK FOR INPUT 


JZ 


LISTIN 


(LOOP UNTIL READY 


IN 


CDATA 


(GET DATA 


ANI 


7FH 


(MASK PARITY 


RET 







The third jump statement at the beginning of BIOS should branch to 
the label CONIN. The lOBYTE at memory address 3 is read. All bits but 
bit 1 (the second bit) are zeroed with the ANI 2 command. List input corre- 
sponds to an lOBYTE of 2 or 3. The logical AND with 2 and either value 
will produce the result of 2. 



0000 0010 
10 

0000 0010 



or 



0000 0011 
10 

0000 0010 



lOBYTE 
AND with 2 



The JNZ instruction will then cause a branch to the list-input routine. 
Otherwise, program flow will continue on to the console-input routine. 
A similar construction can be used for the console status routine. 



( LOGICAL CONSOLE-INPUT STATUS 



const: lda 

ANI 
JNZ 



lOBYTE (GET ASSIGNMENT 
2 (MASK FOR LIST 

LISTST (LIST 



( INPUT FROM VIDEO 

( 

MSTAT: IN CSTAT 
ANI CIMSK 

RZ 

MVI AfOFFH 
RET 



(CHECK STATUS 
(MASK FOR INPUT 
(NO READY 
(SET FOR READY 



( INPUT FROM LIST 



LISTST: IN LSTAT 
ANI LIMSK 

RZ 

MVI ArOFFH 
RET 



(CHECK STATUS 
(MASK FOR INPUT 
(NOT READY 
(SET FOR READY 
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Assemble the new version of BIOS and try it out as we did in the previous 
section. Load the debugger, then use it to change the lOBYTE at address 3. 
First, change the lOBYTE to a value of 3. This will assign the logical console 
input to the printer (or other alternate keyboard) and logical console output 
to the video screen. As soon as you make the change, all further input must 
come from the printer. Use the debugger to change the lOBYTE to a value 
of 2. Now logical console input must come from the printer, and logical 
console output will appear at the printer. Finally, change the lOBYTE back 
to the value of zero. Console input and output should both go through the 
video terminal. 



USING STAT TO CHANGE THE lOBYTE 

The CP/M program called STAT can be used to symbolically change the 
lOBYTE. STAT can also be used to determine the current value of the 
lOBYTE. Each of the four logical devices CON: (consple), RDR: (reader), 
PUN: (punch), and LST: (list) can be assigned to four different physical 
devices. 

Logical device Physical device 







1 


2 


3 


4 


CON: 


console 


TTY: 


CRT: 


BAT: 


UCl: 


RDR: 


reader 


TTY: 


PTP: 


URl: 


UR2: 


PUN: 


punch 


TTY: 


PTP: 


UPl: 


UP2: 


LST: 


list 


TTY: 


CRT: 


LPT: 


ULl: 



The first column represents the four logical peripherals. The remaining 
entries on each line represent the four physical devices. You can easily change 
these names in STAT to something more descriptive. Load STAT into mem- 
ory with the debugger. 

DDT STAT.COM 

Then dump the first few lines. 

DlOO 16F 

You will see the names of the logical peripherals and the physical peripherals 
encoded in ASCII. You can now change any of the names to something else. 
You might want to choose the names 

CRT: 
LST: 
LPT: 
LCR: 
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for the four console devices. These four names correspond to the lOBYTE 
values of through 3. After you change the names with the debugger, return 
to CP/M and save the altered STAT. If the lOBYTE is currently set to zero 
and you type the command 

A>STAT C0N:=LST{ 

STAT will change the lOBYTE to a value of 1 and console output will appear 
at the printer. The lOBYTE can be set back to zero with the command 

A>STAT CONJ=CRTJ 

If you have other peripherals, such as a phone modem, these can also 
be incorporated into lOBYTE. The logical punch can then be sent to the 
modem, the printer, or the console. A disk file can be sent over the phone 
modem with the command 

A>sTAT pun:=b:cpmio.asm 

where CPMIO.ASM is a disk file on drive B. As you can see, there is room for 
a lot of imagination. 

A ROUTINE TO GO ANYWHERE IN MEMORY 

The assembly language program shown in Listing 10.1 can be used to branch 
to any location in memory. Executable programs in CP/M are usually designed 
to be run starting at address 100 hex, since this is where programs are loaded 
by CP/M. There are times, however, when it is desirable to assemble a pro- 
gram for operation at some other location. The system monitor developed in 
Chapter 6 is one such program. If this monitor is to be located in ROM, 
then it must be placed above the CP/M operating system. A location of FOOO 
hex would be ideal. But there is no easy way to get to the monitor from the 
CP/M system. If the GO routine is located on disk drive A, then we have 
only to give the CP/M command 

A>QO FOOO 

and a branch will occur to the address FOOO hex. 

The GO program demonstrates several of the I/O features available with 
CP/M. The branch address given as an argument on the above command line 
is read from a region of memory called the file-control block (FCB). The 
address of the FCB is 5C hex but the ASCII-encoded address starts at 5D 
hex. The input address, FOOO in this example, is a valid hexadecimal number; 
it is to be converted from ASCII into a 16-bit binary number. The result is 
placed into the CPU program counter so that the computer will branch to 
the desired address. The address format is free-form, and leading zeros are 
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Listlnsi 10.1 


A pro^rsBi 


to So 


ansrfuhere 


in memor'sit 






) (date 


Sloes here) 










TITLE 


'GO iJump anywhere)' 






> 

} usage: 


TYPE 


60 F800 TO JUMP TO F800 HEX 


0100 




> 

ORG 


lOOH 






0005 


— 


BOOS 


EQU 


5 


5 DOS ENTRY POINT 


005C 




FCB 


EQU 


5CH 


fFILE CONTROL BLOCK 


0009 




PBUF 


EQU 


9 


fPRINT BUFFER 


OOOA 




RDBUF 


EQU 


10 


?READ CONSOLE BUFFER 


OOOD 




CR 


EQU 


ODH 


^CARRIAGE RETURN 


OOOA 




LF 


EQU 


OAH 


;LINE FEED 






start; 








0100 


2151100 




LXI 


H.FCB+1 


»GET ARGUMENT IF ANY 


0103 


7E 




MOM 


A;M 


?FIRST BYTE 


0104 


FE20 




CP I 




j BLANK? 


OlOA 


CA3B01 




JZ 


ERROR 


I NO ARGUMENT 


0109 


229B01 


A6AINI 


SHLD 


RBUFP 


fSAVE POINTER 


OlOC 


cm 001 




CALL 


READHL 


5QET ADDRESS 


OlOF 


E9 




PCHL 




',Q0 TO ADDRESS 



0110 
0113 
0116 
0118 
0119 

one 

OllF 
0120 
0121 
0122 
0123 
0124 
0125 



210000 
CD6301 
FE20 
C8 

CD2801 

DA3801 

29 

29 

29 

29 

B5 

6F 

C31301 



CONVERT ASC 
TO 16-BIT B 



II -HEX CHARACTERS 
INARY NUMBER IN H?L 



READHL! 
RDHL2: 



LXI 
CALL 
CPI 
RZ 

CALL 

JC 

DAD 

DAD 

DAD 

DAD 

ORA 

MOV 

JMP 



H»0 
6ETCH 



NIB 

RDHL4 

H 

H 

H 

H 

L 

L.A 
RDHL2 



5START WITH 
fGET A BYTE 
f END? 
5 YES 

fTO BINARY 
JNOT HEX 
ITIMES 2 
rTIMES 4 
fTIMES 8 
5TIMES 16 
r COMBINE NEW 
fPUT BACK 
5 NEXT 



0128 
012A 
012B 
012D 
012E 
012F 
0131 
0132 
0133 
0135 
0137 



D630 
D8 

FE17 

3F 

D8 

FEOA 

3F 

DO 

D607 
FEOA 
C9 



f CONVERT ASCII TO BINARY 
f 



nib: 



sui 

RC 

CPI 

CMC 

RC 

CPI 

CMC 

RNC 

SUI 

CPI 

RET 



'0' SASCII BIAS 

f < 
'F'-'O'+l 



i > F 



10 



»A NUMBER 0-9 
'A'-'9'-l 
10 
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> BLANK 


AT END 


OF LINE IS OK 






f ELSE 


AN ERROR 


0138 


FEFO 


f 

RDHL4I 


CPI 


' '-'0' 


013A 


C8 




RZ 








» IMPROPER ARGUMENT » TRY AGAIN 


013B 


117501 


ERROR! 


LXI 


DpMESG » POINT TO MESSAGE 


013E 


Cn5901 




CALL 


PRINT 5 SEND IT 


0141 


119D01 




LXI 


Ds-RBUFM 5 INPUT BUFFER 


0144 


^ A." fc_ Vf J, 




CALL 


READB sGET A LINE 


0147 


1600 




mi 


Df 




■u>rl 7 fil\/ A 




LDA 


RBUFL f BUFFER LENGTH 


014C 


5F 




MOV 


E » A 


014D 


219F01 




LXI 


HjRBUF 


U i. U V 


1 O 
X 7 




DAD 


D f PAST BUFFER 


0151 


3620 




MVI 


Mf ' ' fPUT IN BLANK 


0153 


219F01 




LXI 


Hf RBUF 


0156 


C30901 




JMP 


AGAIN sTRY AGAIN 






1 

f PRINT 


CHARACTERS UNTIL * IS FOUND 


0159 


0E09 


PRINT} 


MVI 


CfPBUF J SET FOR PRINT 


015B 


C30500 




JMP 


BDOS 






! INPUT 


A LINE 


FROM CONSOLE 


015E 


OEOA 


readb: 


MVI 


CRDBUF fREAD INPUT BUFFER 


0160 


C30500 




JMP 


BDOS 






f GET A 


CHARACTER FROM THE INPUT BUFFER 


0163 


E5 


getch; 


PUSH 


H 


0164 


2A9B01 




LHLD 


RBUFP J GET POINTER 


0167 


7E 




MOV 


AfM f GET NEXT CHAR 


0168 


23 




INX 


H » INCREMENT POINTER 


0169 


229B01 




SHLD 


RBUFP ?SAVE POINTER 


016C 


FE61 




CPI 


'Z'+7 f UPPER CASE? 


016E 


DA7301 




JC 


GETC2 (NO 


0171 


E65F 




AN I 


5FH ?MAKE UPPER CASE 


0173 


El 


GETC2J 


POP 


H 


0174 


C9 




RET 








mesg: 






0175 


474F206572 


DB 


'GO error* Input ' 


0183 


7468652061 


DB 


'the address aSain.' 


0197 


0D0A2A24 




DB 


CRfLFf 


019B 


9F0i 


p 

RBUFPJ 


ItU 


RBUF ; BUFFER POINTER 


019D 


OA 


rbufmi 


DB 


10 (MAX SIZE 


019E 




RBUFLI 


DS 


1 (ACTUAL SIZE 


019F 




RBUFf 


DS 


1 f INPUT BUFFER 


OlAO 




> 


END 
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unnecessary. If more than four characters are entered, only the last four are 
used. Thus, all of the following are valid. 

FOOO 
900 PF800 
6000 

If no argument is given to the GO command, or if an invalid hexadeci- 
mal address is entered, then an error message is printed. This step uses the 
console string-output feature, selected with the function code of 9 in register 
C. The DE register pair is loaded with a pointer to the, string location in 
memory. A dollar sign ($) is used to indicate the end of the string. In sub- 
routine SENDM of Chapter 6, a binary zero is used for this purpose since it 
requires less code. 

The user can retype the desired address after the error message has been 
printed. This time, however, the program reads the input string data in a 
different way. The console string-input operation is selected by loading the 
C register with the function number of 10. If the new string is a valid hex 
number, it is converted to a 16-bit binary number. The computer then jumps 
to this address. If the input is still invalid, the error routine is repeated again. 

During the input operation, the usual CP/M commands are available for 
error correction. For example, the most recently typed character can be 
deleted by pressing the DEL key. A control-R will reprint the current line in 
its corrected form. A control-U cancels the entire line so that it can be 
retyped. If Version 2 of CP/M is being used, then the backspace character, 
control-H, can also be used for correcting errors. Finally, a control-C can be 
entered to abort the entire program. This returns control to the CP/M 
operating system. 

Enter the GO program in Listing 10.1. Assemble it and try it out. GO 
is a universal program; it will work on any system. If you have a monitor 
located in memory, use GO to branch to it; if not, you can still try out the 
GO program. Type just the command of GO without an argument. An error 
message should be printed. Type some characters, then delete some of them 
with the DEL key. The deleted characters will be printed a second time. 
Reprint the line with a control-R to see the correct version. Finally return 
to CP/M by giving the address of zero. 

GO 

A control-C can also be used to return to CP/M. 



A LIST ROUTINE WITH DATE AND TIME 

In Chapter 7 we developed a monitor routine for sending data to a separate 
list device. When this routine is activated with a control-P command, the 
output appears at both the console and the printer. CP/M has a similar 
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arrangement. A control-P command will activate the list device, too. Output 
is then sent to both the console and the printer. 

But the console and list routines are entirely separate in CP/M. Output 
can therefore be sent specifically to the list device and it will not appear on 
the console. In CP/M I/O operations, a function number of 2 corresponds to 
console output, and a function number of 5 corresponds to list output. If 
memory address 5 is called with a value of 2 in the C register, then the byte 
in the E register will be displayed on the system console. On the other hand, 
if a function number of 5 is placed in the C register, then the byte in register 
E will appear on the list device. The byte in the E register can be sent to the 
punch by loading a function number of 4 into the C register. 

This complexity may seem unnecessary, since the list device can be 
turned on by typing a control-P. If the command 

A>TYPE: <filen3Bie> 

were given, then the file would be sent to both the console and the printer. 
The disadvantage of this method is that the TYPE command line will appear 
on the printer output. Also, when the listing is finished, the new prompt of 
A> will be printed on the listing. 

The CP/M utility program PIP can be used to send a disk file specifically 
to the list device. The command is 

A>PIP LST i = ;:f i len3H.e.>CT83 

The argument T8, embedded in brackets, will expand the ASCII tab char- 
acter to 8-column fields. PIP, however, does not automatically eject a new 
page when a form feed is encountered. 

The LIST program in Listing 10.2 can be used to send an ASCII disk 
file to the printer, too. It will automatically expand the ASCII tab character. 
Furthermore, when a form-feed character is encountered, LIST will add the 
correct number of lines to the end of the page. At the end of the disk file, 
additional line feeds are issued to finish the page. This will ensure that the 
printer will start the next task on a new page. If the file contains an odd 
number of pages, then an extra blank page is added to the end. Without this 
feature you will have to refold about half of the output. 

If your computer keeps track of the date and time, LIST can print 
current values at the top of the first page. The name of the disk file is also 
printed on this line. 

LIST is a very small program, requiring only IK bytes of memory. It 
was derived from the program called DUMP in the CP/M Interface Guide. 
LIST bears only a passing resemblance to DUMP, however. DUMP is designed 
to convert binary files to ASCII-hex characters and display them on the 
console. LIST, on the other hand, prints ASCII files directly with no conver- 
sion. Since the CP/M BDOS is used for all I/O and disk operations, LIST will 
operate with all standard CP/M systems. 



LINKING PROGRAMS TO THE CP/M OPERATING SYSTEM 231 



Listing 10.2. List an ASCII disk file. 

i SEND ASCII DISK FILE TO LIST 

f PUT DATE AND TIME AT TOP OF PAGE 

i ENTIRE FILE LOADS INTO MEMORY FIRST 

p FORMFEEDS ADDED WITH F ARGUMENT 

f EXTRA PAGE ADDED TO MAKE TOTAL EVEN 

i UNLESS A P OPTION IS GIVEN 

> 

f usage: 







5 


LIST 


<f i len3me> 








f 


LIST 


<f i lena«e> 


F ( add for* feeds) 






i 


LIST 


<f ile^(3l»e> 


P (no extra paae) 






i 


LIST 


<f ileriame> 


n (skip n lines) 






J (date ^oes 


here ) 








r 

TITLE 


'List 


an ASCII disk f ile. ' 


0100 




9 

ORG 


lOOH 






0005 


= 


BDOS 


EQU 


5 


fDOS ENTRY POINT 


0001 




CONS 


EQU 


1 


JREAD CONSOLE 


0005 


~- 


TYPEF 


EQU 


5 


rLIST OUTPUT 


0009 




PBUF 


EOU 


9 


f PRINT CONSOLE BUFFER 


OOOB 


= 


BRKF 


EQU 


11 


fKILL? (TRUE IF CHAR) 


OOOF 




OPENF 


EQU 


15 


fFILE OPEN 


0014 


= 


READF 


EQU 


20 


JREAD FUNCTION 


OOOD 




CR 


EQU 


ODH 


> CARRIAGE RETURN 


OOOA 


_ 


LF 


EQU 


OAH 


;line feed 


OOIA 




EOF 


EQU 


lAH 


fEND OF FILE 


0009 




TAB 


EQU 


9 


f "I 


OOOC 




FORMED 


EQU 


OCH 


JFORM FEED 


003A 




LINES 


EQU 


58 


ILINES/PAGE 


0042 


= 


LMAX 


EQU 


66 


$HAX LINES 


005C 


_ 


FCB 


EQU 


5CH 


f FILE CONTROL BLOCK 


0080 




BUFF 


EQU 


80H 


fDISK BUFFER ADDR 






? FILE- 


-CONTROL BLOCK DEFINITIONS 


005D 


= 


f 

• FCBFN 


EQU 


FCB + 1 


fFILE NAME 


Art i O 




FCBRL 


EQU 


FCB+12 


{CURRENT REEL # 


007C 




FCBCR 


EQU 


FCB+32 


f NEXT REC #(0-127) 






i TIME 


AND DATE FROM A COMPU/TIME BOARD 


00C4 




f 

ADATA 


EQU 


0C4H 


fPORT A DATA 


00C5 




ACONT 


EQU 


ADATA+1 


fPORT A CONTROL 


00C7 




BCONT 


EQU 


ADATA+3 


5 PORT B CONTROL 


00C6 




BDATA 


EQU 


ADATA+2 


5 PORT B DATA 






s 

i SAVE 


OLD STACK AND SET 


UP A NEW ONE 


0100 


210000 


start: 


LXI 


H?0 




0103 


39 




DAD 


SP 




0104 


22E004 




SHLD 


OLDSP 


fSAVE STACK 


0107 


310005 




LXI 


SPr STACK 




OlOA 


111E04 




LXI 


D» RULES 




OlOD 


CD3E02 




CALL 


PRINT 


rHOW TO ABORT 
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i HOW MANY LINES TO SKIP BEFORE STARTING? 

9 



0110 


210000 




LXI 


H?0 




0113 


016D00 




LXI 


B»6DH 


5 3RD ARGUMENT 


0116 


OA 


SKIP2! 


LDAX 


B 


AOicrx r*iuiA.c«A.r*X'a;rio 
UHAKhLiIciK 


0117 


FE20 




CP I 






0119 


CA4001 




JZ 


bMFvi 




one 


FE4& 




CP I 


' F ' 


?NEED FORM FEEDS? 


OllE 


CA3C01 




JZ 


FORM 


? YES 


0121 


FE50 




CP I 


P 


X ffr V T fi j\ St:, A r- o 

I* EXTRh PAGET 


0123 


CA3601 




JZ 


NOPAGE 


? NO 


0126 


D630 




SUI 


Q 








f 

} CONVERT ASCII 


iJClL/ A riHi. 


lis sf±nHt\i IN n 9 L. 


0128 


54 


t 


MOV 


D»H 


^DUPLICATE 








MOV 


CPU 




012A 


29 




DAD 


H 


f TIMES 2 


012B 


29 




DAD 


H 


f TIMES 4 




1 7 




DAD 


t' 


STTMCC 




OO 
£.7 




DAD 


M 

n 


B T T MFQ 1 A 
9 t M. ncD J. \/ 


012E 


5F 




MOV 


E»A 




012F 


1600 




MVI 


D;0 




0131 


19 




DAD 


D 


5 ADD NEW BYTE 


0132 


03 




I NX 


B 


JINCR POINTER 


0133 


C316U1 




JMP 


SKIP2 


»NEXT 




o n Q n j4 


nopage: 


STA 


PFLAG 


5 NO EXTRA PAGE 


0139 


C33F01 




IMP 


ZERO 








form; 


STA 


FFLAG 


;SET FOR FORM FEEDS 




Rr 


ZEROt 


XRA 


A 


» RESET COUNT 


Ol'lO 




SKIPS! 


SHLD 


SKIPS 


fSAVE BINARY CNT 






f READ 


AS MUCH 


AS POSSIBLE INTO MEMORY 






i 


CALL 


SETUP 


fSET UP INPUT FILE 


0146 


3E80 




MVI 


ArSOH 




0148 


"T O Ti r" /\ A 

32DE04 




STA 


IBP 


5SET POINTER TO 80H 


014B 


32D304 




STA 


TIME2 


;SET 1ST PASS 


014E 


2ADA04 


f 


LHLD 


SKIPB 


IHOW MANY LINES? 


0151 


7C 


MAIN6J 


MOV 


Af H 




013<^ 


tic* 




ORA 


L 


fHi-L = 0? 


U 1 Do 






JZ 


MAINS 


»N0 SKIP 


0156 




HA1N7I 


PUSH 


H 




0157 


CD4302 




CALL 


GNB 


5 NEXT BYTE 


015A 


El 




POP 


H 




015B 


FEOD 




CPI 


CR 




015D 


C25601 




JNZ 


MAIN7 


rLOOK FOR CR 


0160 


2B 




DCX 


H 


5DECR COUNT 


0161 


C35101 




JMP 


MAIN6 




0164 


AF 


5 

MAINS? 


XRA 


A 




0165 


32D504 




STA 


FULL 


; RESET FLAG 


0168 


CD4302 


MAIN2: 


CALL 


GNB 


>GET A BYTE 


016B 


E5 




PUSH 


H 
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o Anr* A A 




1 Lii n 


UUr r r 


pntnORY PuINTER 


016F 


77 






n 9 H 


2 DMT OVTC* TM 


0170 


23 






H 




0171 


22DC04 

JIm 4U« il^ lU/ V ™ 






jpwr r r 


« Qj6UP PflTKITPS? 


0174 


■47 




MOV 






0175 


3EFF 




H V I 


A _ OPFH 
L"i / v/r i n 




0177 


BD 




irfi ir 


1 


9Li — \fl 


0178 


w /i. U JP V X 






T 

riH * 
















m 7fi 


T[AA7 AA 






/ 


9 r DUS 


y 1 /c. 


ri i A 




SUI 


10 


r CCP -1 


V 1 O V 






t/flr 


H 


pTOO BIGt 


0181 


D28B01 




JNC 


MAIN4 




0184 


3E1A 




MVI 


AfEOF 




018A 


77 




MOV 


Mf A 


>PUT IN MEMORY 


0187 


32D504 




STA 


FULL 


ISET FOR FULL 




T / 




MOV 


Bf A 






/ O 


MAT hi A « 


MOV 


ApB 


i r* cr T OVTC" 
9 ut 1 fclY 1 fc 


01 HP 


F1 




POP 


H 




018D 






CP I 


EOF 




V A or 






JNZ 


MAIN2 








f t/rlfc.l/j\ 


FOR EOF AT END 




0192 


2ADC04 


f 


LHLD 


BUFFP 


pCET POINTER 


0195 


2B 




DCX 


H 




0196 


3E1A 




MVI 


ArEOF 




OatS 


BE 




CMP 


M 


jEOF? 


0199 


CAAlOl 




JZ 


MAIN3 


; YES 


019C 


23 




INX 


H 




Ai on 


/ / 




MOV 


Mf A 


fPUT IN EOF 


1 OP 






SHLD 


BUFFP 




01 Al 


rri7rA^ 


> 

MAIN3J 


CALL 


RESET 


JPOINTER 






9 PUT TIME AT 


START OF 


LISTING 






5 REMOVE FORMFEED IF FIRST 


01A4 


CD5D03 


y 


CALL 


CLOCK 


5 GET TIME 


C) 1 A7 

V J. H / 






LDA 


FFLAG 


5 FORMFEEDS? 




R7 




ORA 


A 




m AD 


L^r 60I 




CNZ 


TWOLN 


f YES 


A 1 AET 
\/ 1 HCl. 






CALL 


GETS 


J GET BYTE 




PC AP 




CPI 


FORMED 


f FORMFEED 


A 1 R T[ 






JNZ 


GL0P2 


?N0 


1 FlA 
V J. t* p 






CALL 


TWOLN 


; SEND 2 LF 


V J. £< 7 


rnspA9 


f 

GLOOPI 


CALL 


GETB 


?GET NEXT BYTE 


01 BC 


47 


GL0P2; 


MOV 


B?A 


fSAVE BYTE 




w w r A.I u ^ 




CALL 


TABO 


5PRINT BYTE 




7n 




MOV 


A»B 


fGET BYTE AGAIN 


OlCl 


FEOA 




CPI 


LF 


lEND OF LINE? 


01C3 


C2B901 




JNZ 


GLOOP 


im 


01C6 


3AD604 




LDA 


LCOUNT 


»6ET COUNT 


01C9 


3C 




INR 


A 


5 INCREMENT IT 


OICA 


320604 




STA 


LCOUNT 


5 SAVE IT 


01 CD 


FE42 




CPI 


LMAX 


{TOO MANY? 


OICF 


D43202 




CNC 


NPAGE 


fYESy RESET 


01112 


3AD8G4 




LDA 


FFLAG 


»FORM FEEDS? 
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01D5 


B7 




ORA 


A 




01D6 


rAB901 

Kurt iJ f \J X 




JZ 


GLOOP 


f NO 


0109 


3AD604 




LDA 


LCOUNT 


IGET COUNT 


OlDC 


FE3A 




CPI 


LINES 


?END OF PAGE'? 


OlDE 


DAB901 




JC 


GLOOP 




OlEl 


CD1B02 




CALL 


FILL 


>NEW PAGE 


01E4 


CDF601 




CALL 


TWOLN 




01E7 


C3B901 


f 


JMP 


GLOOP 








f CHECK 


: FOR ABORT 5 ANY 


KEY PRESSED 


OlEA 


E5 


f 

ABORT 5 


PUSH 


H 


SSAVE 


OlEB 


ns 




PUSH 


D 










PUSH 


B 




OlED 


OEOB 




MVI 


CrBRKF 


(CONSOLE READY 


OlEF 


CD0500 


PCHAR2S 


CALL 


BDOS 




OlF-2 


Cl 




POP 


B 


►RESTORE 


0iF3 


Dl 




POP 


D 




01F4 


El 




POP 


H 




01F5 


C9 




RET 






01F6 


060A 


TWOLNI 


mi 


BrLF 


fTWO LINES 


01F8 


3AD604 




LDA 


LCOUNT 




OlFB 


3C 




INR 


A 


fADD 2 TO 








INR 


A 


i rniiwT 

7 U U 1^ 1 


OiFD 


320604 




STA 


LCOUNT 




0200 


CD0302 


0UTT2S 
? 


CALL 


OUTT 


? DOUBLE OUTPUT 


0203 


78 


outt; 


Hoy 


A?B 


f OUTPUT FROM B 






i 

J SEND 


CHARACTER FROM A 


TO LIST 


0204 


E5 


PCHAR J 


PUSH 


H 




0205 


D5 




PUSH 


D 




0206 


C5 




PUSH 


B 


p SAVED 


0207 


0E05 




MVI 


CpTYPEF 


5LIST 


0209 


5F 




MOV 


E^A 




020A 


FEOC 




CPI 


FORMED 


» FORMFEED? 


020C 


C2EF01 




JNZ 


PCHAR2 


SPRINT BYTE 






i 

i FILL, 


OUT PAGE 


AFTER FORMFEED 


020F 


rrii ROC 




CALL 


FILL 




0212 


060A 




MVi 


B>LF 


."FOR FORMFEED 




^ k.'\J O \/ tL. 




CALL 


OUTT 




0217 


Cl 




POP 


B 




0218 


Dl 




POP 


D 




0219 


El 




POP 


H 




021A 


C9 


5 


RET 










i FILL 


OUT END 


OF PAGE 




021B 


3AD604 


FILLJ 


LDA 


LCOUNT 


JLINE COUNT 


021E 


4F 




Moy 


Cf A 




02 IF 


CD3202 




CALL 


NPAGE 


ilNCR PAGE 


0222 


3E42 




MMI 


A»LMAX 




0224 


91 




SUB 


C 




0225 


D8 




RC 




5T00 BIG 
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0226 C8 

0227 4F 

0228 060A 
022A CD0302 
02211 OD 
022E C22A02 
0231 C9 



f-ILL2? 



RZ 

MOV 

MVI 

CALL 
DCR 
JNZ 
RET 



Cf A 
BfLf 
OUTT 
C 

FILL2 



?SEND LF 



» RESET LINE COUNT* INCREMENT PAGES 



0232 AF 

0233 32D604 
0236 3AD704 
0239 3C 
023A 320704 
023D C9 



NPABE5 



XRA 
STA 
LDA 
INR 
STA 
RET 



A 

LCOUNT 

PAGES 

A 

PAGES 



SGET A ZERO 
5LINE COUNT 
J PAGE COUNT 



; SEND MESSAGE TO CONSOLE 



023E 0E09 
0240 C30500 



print: 



MMI 
JMP 



CfPBUF 
BDOS 



) GET NEXT BYTE FROM DISK BUFFER 



0243 3ADE04 
0246 FE80 
0248 C24F02 



GNBI 



LOA 

CP I 
JNZ 



IBP 
80H 
READ 



) READ ANOTHER BUFFER 



024B CDDA02 
024E AF 



CALL 
XRA 



DISKR 
A 



i READ THE BYTE AT BUFF+REG A 



024F 5F 
0250 1600 

0252 3C 

0253 32DE04 



0256 E5 

0257 218000 
025A 19 
025B 7E 



025C El 
025D 23 
025E C9 



READJ 



MOV 

MVI 
INR 
STA 



Ef A 

A 

IBP 



5 POINTER IS INCREMENTED 

i SAVE THE CURRENT FILE ADDRESS 

PUSH H 

LXI HfBUFF 

DAD D 

MOV Af M 

BYTE IS IN THE ACCUMULATOR 
; RESTORE FILE ADDRESS AND INCREMENT 

POP H 

I NX H 

RET 



r GET A BYTE FROM MEMORY BUFFER 



025F E5 
0260 2ADC04 
0263 7E 
23 

22DC04 



GETBJ 



0264 
0265 



PUSH 

LHLD 

MOV 

INX 

SHLD 



H 

BUFFP 

Af M 
H 

BUFFP 
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0268 


El 




POP 


H 




0269 


E67F 




ANI 


7FH 


JSTRIP PARITY 


026B 


FEIA 




CPI 


EOF 




026n 


CO 




RNZ 






026E 


Fl 




POP 


PSW 


; RAISE STACK 


026F 


3AD504 


5 


LDA 


FULL 


» CHECK FLAG 


0272 


B7 




ORA 


A 


5 ZERO? 


0273 


CA8E02 




JZ 


FINIS 


JYESf DONE 


0276 


Cn7C02 




CALL 


RESET 


f POINTER 


0279 


C36401 


? 


JMP 


MAINS 


;get more 






9 RESET 


MEMORY POINTER 




027C 


E5 


f 

RESET J 


PUSH 


H 




027D 


210005 




LXI 


HfBUFFER 


0280 


22DC04 




SHLD 


BUFFF 




0283 


El 




POP 


H 




0284 


C9 


i 


RET 






0285 


110204 


noname: 


LXI 


DfMESl 


5P0INT TO MES£ 


0288 


CD3E02 


FINI3J 


CALL 


PRINT 




028B 


C3AE02 




JMP 


AB0R2 








f 

f NORMAL END 


OF OF LISTING 


028E 


32D404 


finis: 


STA 


EOFFL 


fSET EOF FLAG 


0291 


CD1B02 


9 


CALL 


FILL 


;OUT PAGE 






y 

f ADD AN EXTRA PAGE IF 


THERE IS AN DDI 






f AND P 


FLAG 


IS NOT SET 




0294 


3AD904 


> 


LDA 


PFLAG 




0297 


B7 




ORA 


A 


fZERO? 


0298 


C2AE02 




JNZ 


AB0R2 


?N0 


029B 


3AD704 




LDA 


PAGES 


SHOW MANY? 


029E 


E601 




ANI 


1 


5 ODD? 


02A0 


CAAE02 




JZ 


AB0R2 


rNO 



i ADD BLANK PAGE TO MAKE EVEN 



02A3 0642 
02A5 3E0A 
02A7 CD0402 
02AA 05 
02AB C2A502 



} (CAN WE CALL FILL?) 



EPAGE! 



MVI 

MVI 

CALL 

DCR 

JNZ 



B.LMAX 

AfLF 

PCHAR 

B 

EPAGE 



KLINES 



02AE 2AE004 
02B1 F9 
02B2 C9 



AB0R2; 
AB0R3t 



LHLD 
SPHL 
RET 



OLDSP 



SOLD STACK POINTER 



SETUP FILE AND OPEN FOR INPUT 



LINKING PROGRAMS TO THE CP/M OPERATING SYSTEM 237 



02B3 115C00 
02B6 OEOF 
02B8 CD0500 



SETUP I 



LXI 
CALL 



Df FCB 

CfOPENF 

BDOS 



CHECK FOR ERRORS 



02BB FEFF 
02BD CAC502 



CPI 
JZ 



255 

BADOPN 



fNo good 



; OPEN IS ok 



02C0 AF 
02C1 327C00 
02C4 C9 



XRA 
STA 
RET 



A 

FCBCR 



i BAD OPEN 



02C5 


215D00 


BADOPN J 


LXI 


HtFCBFN 


y 1ST CHAR 


02C8 


7E 




Moy 


AyM 


5 GET IT 


02C9 


FE20 




CPI 




yFILE NAME? 


02CB 


CA8502 




JZ 


NONAME 


r NU 


02CE 


213F24 




LXI 


H» 


ySET UP FOR PRINT 


02D1 


226800 




SHLD 


FCBRL 




02D4 


115D00 




LXI 


DyFCBFN 


yFILENAME 


02D7 


C38802 




JMP 


FINI3 


yOUIT 






? 

y READ 


DISK FILE RECORD 




02DA 


E5 


f 

diskr: 


PUSH 


H 




02DB 


05 




PUSH 


D 




02DC 


C5 




PUSH 


B 




02DD 


115C00 




LXI 


DfFCB 




02E0 


0E14 




MVI 


CjREADF 




02E2 


CD0500 




CALL 


BDOS 




02E5 


CI 




POP 


B 




02E<4 


Dl 




POP 


D 




02E7 


El 




POP 


H 




02E8 


B7 




ORA 


A 


? CHECK FOR ERRS 


02E9 


C8 




RZ 




yOK 






} MAY BE EOF 






02EA 


FEOl 




CPI 


1 




02EC 


CAF502 




JZ 


FEND 


yEOF 


02EF 


111104 




LXI 


DyMES2 




02F2 


C3AE02 




JMP 


AB0R3 








5 

9 FOUND 


DISK 


EOF 




02F5 


2A0CO4 


y 

FEND 5 


LHLD 


BUFFP 


5 GET POINTER 


02F8 


3A1A 




MVI 


My EOF 


5PUT IN lA 


02FA 


C3A101 




JMP 


MAIN3 





y TAB COUNTER ROUTINE 

y JUMP HERE WITH BYTE IN B 
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02FD 


78 


TABOJ 


MOV 




A;B 


p6ET byte 


02FE 


FE20 




CP I 






? CONTROL CHAR? 


0300 


DA1E03 




JC 




TABCR 


j YES 


0303 


CD0903 




CALL 




TABN 


fINCR COUNTER 


0306 


C30302 




JMP 




OUTT 


fSEND BYTE 






Y 

f INCREHENT TAB 


COUNTER 








f MAKE 


MODULO 


8 






0309 


3AD204 


r 

TABNJ 


LDA 




TABC 


fGET TAB COUNT 


030C 


3C 




INR 




A 


f INCREMENT IT 


030D 


E607 




ANI 




7 


fMODULO 8 


030F 


32D204 




STA 




TABC 


JSAVE IT 


0312 


C9 




RET 












f 

f READ 


THE BYTE 


AFTER ABORT 


0313 


CD1B02 


DONE ! 


CALL 




FILL 


SOUT PAGE 


0316 


OEOl 




MVI 




CcCONS 


IREAD CONSOLE 


0318 


CD0500 




CALL 




BDOS 




031B 


C3AE02 




JMP 




AB0R3 


; RETURN 






y 

f IF CARRIAGE 


RETURN THEN ZERO COUNT 


031E 


FEOD 


TABCR5 


CPI 




CR 




0320 


C23103 




JNZ 




TABI 


J NOT CR 


0323 


COEAOl 




CALL 




ABORT 




0326 


OF 




RRC 






rKEY PRESSED? 


0327 


DA1303 




JC 




DONE 


pQUIT 


032A 


AF 




XRA 




A 


f GET A ZERO 


032B 


32D204 




STA 




TABC 


fSET TO ZERO 


032E 


C30302 




JMP 




OUTT 


?SEND CR 






» 

5 CHECK 


FOR TAB 


(CONTROL 


-I ) 


0331 


FE09 


TABIS 


CPI 




TAB 




0333 


C24003 




JNZ 




TFORM 


5 NOT TAB 


0336 


CD5803 


TAB2S 


CALL 




BLANK 


rSEND A BLANK 


0339 


CD0903 




CALL 




TABN 


fINCR TAB COUNT 


033C 


C23603 




JNZ 




TAB2 


jMORE 


033F 


C9 




RET 






fNO PRINT 






i 

t CHECK 


FOR FORMFEED 




0340 


FEOC 


S 

TFORMJ 


CPI 




FORMFD 




0342 


C20302 




JNZ 




OUTT 




0345 


3AD804 




LDA 




FFLAG 


fFORM FEED OPTION? 


0348 


B7 




ORA 




A 




0349 


C25403 




JNZ 




TF0R2 


f OTHER CONTROL 


034C 


060A 




MVI 




B?LF 




034E 


Cri0302 




CALL 




OUTT 




0351 


C31B02 




JMP 




FILL 


f NORMAL FORMFEED 


0354 


Fl 


TF0R2; 


POP 




PSW 


r RESTORE STACK 


0355 


C3B901 




JMP 




BLOOP 


fNEXT BYTE 



f 

t SEND A BLANK 
5 
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0358 


3E20 


BLANK J 


MVI 


A» ' ' 




035A 


C30402 


} 


JHP 


PCHAR 


pSEnd it 


035D 


DBC4 


CLOCK? 


IN 


ADATA 


» BOARD PRESENT? 


035F 


FEFF 




CPI 


OFFH 




0361 


C8 




RZ 




7 NO 


0362 


3AD304 




LDA 


TIME2 


JPASS? 


0365 


B7 




ORA 


A 


?ZERO? 


0366 


C8 




RZ 




fNOT 1ST 


0367 


AF 




XRA 


A 




0368 


32D304 




STA 


TIME2 


5SET 1ST 


036B 


21DE03 




LXI 


HjMON 




036E 


CDA703 




CALL 


DATE 


fGET IT 


0371 


21ED03 




LXI 


Hs>HOUR 




0374 


cncoo3 




CALL 


TIME 




0377 


21D703 




LXI 


HrPDATE 


; POINT DATE/TIME 


037A 


CD8A03 




CALL 


SEND 




037D 


AF 




XRA 


A 


JGET A ZERO 


037E 


326900 




STA 


FCB+13 


JNAME END 


0381 


215D00 




LXI 


HfFCBFN 


?NAME START 


0384 


CD8A03 




CALL 


SEND 


rSHOU 


0387 


21FF03 




LXI 


HjSCRLF 








9 

} SEND 


HESSAGE 


TO LIST 




038A 


7E 


SEND J 


MOM 


A»M 


?6ET BYTE 


038B 


B7 




ORA 


A 


IZERO AT END 


038C 


C8 




RZ 




rOONE 


038D 


CD0402 




CALL 


PCHAR 


JSEND CHARACTER 


0390 


23 




INX 


H 


» INCREMENT POINTER 


0391 


C38A03 




JMP 


SEND 








r 

9 READ 


A DIGIT 






0394 


7A 


5 

FCDIGI T 


J MOV 


ApD 


fSELECT DIGIT 


0395 


D3C4 




OUT 


ADATA 




0397 


DBC4 




IN 


ADATA 


fRESET INTERRUPT 


0399 


DBC5 


DWAITJ 


IN 


ACONT 


fDIGIT PRESENT^ 


039B 


E680 




ANI 


80H 




039D 


CA9903 




JZ 


DUAIT 


5 LOOP UNTIL READY 


03A0 


DBC4 




IN 


ADATA 


>READ A DIGIT 


03A2 


E60F 




ANI 


OFH 


rMASK 


03A4 


F630 




ORI 


30H 


5C0NVERT TO ASCII 


03A6 


C9 




RET 










f 

y READ-DATE ROUTINE 




03A7 


AF 


V 

DATEI 


XRA 


A 


SDATE DISPLAY MODE 


03A8 


n3C6 




OUT 


BDATA 




03AA 


4F 




MOV 


Ci-A 


fTHIS IS DATE 






f 

i READ 
5 


FOUR DIGITS 




03AB 


1600 


READ4: 


MVI 


Ds>0 


JSELECT FIRST DIGIT 


03AD 


CD9403 


RD4: 


CALL 


RDIGIT 


JDELAY ONE DIGIT SCAN 


03B0 


CDCD03 




CALL 


RSDIG 


5READ X STORE DIGIT 


03B3 


7A 




MOV 


A»D 




03B4 


FE20 




CPI 


20H 


rTWO DIGITS DONE? 
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03B6 


C2BA03 




JNZ 


SKIP 


fSKIP A PLACE 








INX 




fSKIP t OR / 




r C.*! V 


tik' TP J 


CPI 


40H 






Lr iL. rt A.* V O 




JNZ 


RD4 


JGET ANOTHER DIGIT 


/\ "jf iTj r~ 


UT 














9 r\ I-. ri Ji' 


TTMF % 


RFAFl AND 


<3TDRE DIGIT 




*5fc.4y 


} 

T T MC * 


MIJ T 


ri 9 *i\Jri 










nirr 


4? r) 1 fi 






AP A 1 




MU T 


C f 1 


i THIS IS TIME 




PflAPt A"!t 
L/ JL' M £• V 




CALL 


READ4 


5QET 4 DIGITS 


\y *j o / 


23 




INX 


H 


J SKIP COLON 


03CA 


CDCD03 




CALL 


rsdig 




03CD 


CD9403 


RSDIBt 




RDIGIT 




03D0 


77 




MOV 


Mf A 


f STORE BYTE 


03D1 


23 




INX 


H 


JINCR POINTER 




/ n 




MOV 


A f D 






P A 1 




ADI 


lOH 






sj / 




MOV 






03D6 


f*o 
UT 




RET 










j STORAGE AREA 










? 

PDATEI 








VOL> / 


0D0A446174 




DB 


C R ? L F f 


'D3te ' 


HP 


7i3782F 


MONJ 


DB 




J MONTH 




78782F 




DB 


'KX/' 


»DAY 




3830 




DB 


'80' 


f YEAR 




202054696D 


DB 


' Time ' 


mpn 


78783A 


HOUR! 


OB 


XJ\ ♦ 


> HOURS 




78783A 




DB 


' XX J ' 


JMINUTES 


vor o 


7878 




DB 


'XX' 


> SECONDS 




2020204669 




DB 


File? 'pO 


Uor r 


ODOAOO 


scrlf: 


DB 


CRyLFf 







0D0A4E6F20MES1 t 


DB 


CR ? LF ? 


'No file name*' 


041 1 


0D0A446973MES2: 


OB 


CRi-LFf 


'Disk error*' 


\)*tlC. 


onoA 


RULES J 


DB 


CRpLF 






50726F6772 




OB 


'Prosrsm to list ASCII files' 


fSA'XVt 


ODOA204F70 




DB 


CR p LF ? 


' Options X ' 


CiAAA 


202863686F 


DB 


' (choose one)'pCRiiLF 


\ff\J\j 


2020462061 




DB 


' F 3dds form feeds' fCR?LF 




2020502073 


DB 


' P skips extra even P33e' 


0483 


2061742065 




DB 


' at end'jCRfLF 


048C 


2020446563 


DB 


' Decimsl number skips ' 




6C696E6573 


OB 


' 1 ines 


at beainnins' pCRpLFjLF 


04B8 


2050726573 


DB 


' Press 3ny key to abort.' 


04D0 


0A24 




DB 


LFf 'f ' 






00 


TABC? 


DB 





pTAB COUNTER 




80 


TIME2; 


DB 


80H 


ppASS 




FF 


EOFFLJ 


DB 


OFFH 


5 EOF FLAG 




00 


FULL} 


DB 





JFULL FLAG 


04D6 


02 


LCOUNT 


5 DB 


2 


5LINE COUNT 


04D7 


00 


PAGES J 


DB 





pPACE COUNT 


04D8 


00 


fflag; 


OB 





JFORMFEED FLAG 


04D9 


00 


pflag; 


DB 





; EXTRA -PAGE FLAG 


04DA 


0000 


skipb: 


DW 





pLINES TO SKIP 


04DC 


0005 


BUFFPJ 


DU 


BUFFER 


p POINTER 


04DE 




I BP 5 


OS 


2 


p INPUT BUFF POINTER 
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04E0 
04E2 



OLDSPJ 



STACK AREA 

ns 2 

DS 30 



f OLD STACK 
JSTACK SPACE 
5 NEW STACK 
5 MEMORY BUFFER 



0500 



stack; 
buffer: DS 



1 



0501 



END 



LIST can be executed by the command 

A>LIST <filen3iiie> <option3l arsumentls- 

The CP/M system copies LIST into memory at 100 hex and branches to it. 
The first step is to save the incoming stack pointer and set up a new one. The 
clock routine is executed next. The routine shown in Listing 10.2 is written 
for a Computime R clock board, but the program can be altered to accommo- 
date other methods of timekeeping. The first step of the clock routine is to 
see if there is a clock board in the computer. One of the clock ports, at 
address ADATA, is read. If there is no port at this I/O address, the computer 
will read a value of FF hex. This will harmlessly terminate the subroutine 
with a return instruction. 

If a clock board is present, then the first hne of the printer output will 
appear in the form 

Date 06/15/80 Time 13U8I33 FILEI <f ilen3»e> 

The next step is to see if one of the three optional arguments was given after 
the filename. These arguments are: 



The letter F is used to insert form feeds every 58 lines of the listing. The 
command looks Uke this. 

A>LIST SORT. PAS F 

This feature is useful for listing BASIC, FORTRAN, Pascal, or assembly- 
language source programs. If this argument is selected, the proper number of 
line feeds is generated as the end of the page is approached. This step causes 
the printer to skip over the fold in the paper. Also, any form feeds that are 
encountered are ignored. 

If the letter P is given for the argument, then no extra blank page is 
generated at the end. This argument can be used to save paper when several 
one-page files are printed. 



F 
P 

decimal number 



(add form feeds) 
(no extra page at end) 
(skip lines at beginning) 
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Another possible argument to LIST is a decimal number. In this case, 
the argument tells how many lines of the file are to be skipped. For example, 
the command 

A>LIST LINFIT»FOR 500 

will skip the first 500 lines and start the listing with line 501. Use this option 
if you want to print the last part of a long file but don't want to wait for the 
first part to be printed. 

At this point, the disk directory is searched for the requested filename. 
This filen£ime is retrieved from the file-control block at address 5C hex. If 
the requested filename can't be found in the directory, then the filename is 
printed on the console along with a question mark. LIST is then aborted. If 
no filename was entered, an error message stating this fact appears on the 
console. LIST is aborted in this case also. LIST could have been programmed 
to handle input errors the way that the GO routine does. Then, instead of 
aborting, LIST would ask for the filename to be entered again. The addition 
of this feature is left as an exercise for the reader. 

If the filename exists in the directory, then the requested disk file is 
read. The proper number of lines are skipped over if the second argument of 
the command line was a valid decimal number. At this point, the disk file is 
read into memory. The FDOS address located at address 7 is checked to see 
how much memory is available. The entire file will be copied into memory 
if there is room. A chock is made to see if the disk end-of-file character is 
encountered before the available memory is filled. 

In either case, the date and time of day are printed first. Then the data 
in memory are printed. The first character is ignored if it is an ASCII form 
feed. This will prevent a page eject immediately after the date and time. The 
ASCII tab character is properly expanded by the routine TABO. The number 
of lines is counted. When a form-feed character is encountered, the proper 
number of line feeds is issued to fill out the page. If the F argument was 
given, the form feeds will be automatically issued. 

LIST can be aborted at any time during the printing by pressing any 
console key. The console is checked for this after each carriage return. The 
CP/M program DUMP is set up a little differently. The disk data are read 
into a 128-byte buffer, rather than into the memory area above 100 hex. 
Using a small buffer has the advantage that programs can be stored in mem- 
ory during the DUMP operation and they will not be erased. But, in return, 
there is a lot of disk activity. The disk must be accessed every 128 bytes. 



COPY A DISK FILE INTO MEMORY 

If you have programmed one of the tape routines given in Chapter 8, then 
you can make backup copies of your disk files. But you have to first copy 
the disk file into memory. The copy step can be performed with the debug- 
ger DDT or SID. 
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A>SID <filen3iiie> 

This command loads the debugger at address 100 hex and branches to it. The 
debugger relocates itself into high memory, then copies the requested disk 
file into memory starting at 100 hex. The address of the end of the disk file 
in memory is printed in hexadecimal. This address can be used in conjunc- 
tion with the memory map given in Appendix B to determine the number of 
256-byte blocks in the file. For example, if DDT gives a value of 13AF, then 
the disk file occupies 19 (decimal) blocks of 256 bytes. 

When the file has been copied into memory, the G command in the 
debugger can be used to branch to the tape routine. Then the SAVE com- 
mand can be given to make a copy on tape. The process can be reversed by 
loading the file into memory from tape. Branch to address zero to restart 
CP/M. Finally, give the SAVE command 

A>SAME XX <filen3iiie> 

where XX is the decimal number of 256-byte blocks to be saved. 

This procedure can be simplified by using the FETCH program given in 
Listing 10.3. FETCH uses CP/M for all I/O and disk operations, so it should 
work with all standard CP/M systems. There are, however, 2 items that need 
to be customized. Fetch is initially loaded into memory at 100 hex. It then 
automatically relocates itself to higher memory. The relocation address is 
chosen to be F400 hex in Listing 10.3. You may have to change it to some 
other address if this region is not available. The address is defined by the 
label ORIGIN in the source program. After FETCH copies the requested disk 
file into memory, it branches to your tape routine. This address, defined by 
the label MONIT, is chosen to be FOOO hex in Listing 10.3 MONIT should be 
changed to your tape address. 

ListinsS 10. 3» Copy s disk file into meiiiora. 



5 THIS PROGRAM RELOCATES ITSELF TO HIGH MEMORY THEN 

? COPIES A DISK FILE TO MEMORY STARTING AT 100 HEX, 

i ASCII AND COM FILES ARE CORRECTLY HANDLED. 

5 GIVE A THIRD ARGUMENT OF B FOR OTHER BINARY FILES, 

5 A lA EOF CHARACTER IS PUT AT THE END ASCII FILES, 

} THE LAST ADDRESS AND DECIMAL BLOCK SIZE ARE GIVEN. 

i FINALLY A JUMP IS MADE TO THE ADDRESS OF MONIT, 



f (date 3oes here) 



TITLE 



'Copy 3 disk file into memory,' 



S QUITS IF NO READ-WRITE MEMORY AT NEW LOCATION 



FOOO 
F400 



MONIT 
ORIGIN 



E«U 
EQU 



OFOOOH 
0F400H 



;G0 HERE WHEN DONE 
5 RELOCATE FETCH HERE 



0100 
0005 



BUFFER EQU 
BDOS EQU 



lOOH 

5 



> START MEMORY BUFFER 
pDOS ENTRY POINT 
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0002 = 
0009 = 
OOOF = 
0014 = 
OOOD = 
OOOA = 
OOIA = 

005C = 
0080 = 



TYPEF EQU 2 » CONSOLE OUTPUT 

PBUF EQU 9 ; PRINT CONSOLE BUFFER 

OPENF EQU 15 pFILE OPEN 

READF EQU 20 SREAD FUNCTION 

CR EQU ODH JCARRIAQE RETURN 

LF EQU OAH fLINE FEED 

EOF EQU lAH 5END OF FILE 

i 

FCB EQU 5CH 5FILE CONTROL BLOCK 

BUFF EQU 80H » INPUT DISK BUFFER ADDR 



f FILE CONTROL BLOCK DEFINITIONS 



005D = 
0065 = 
0068 = 
007C = 

0100 



FCBFN 
FCBFT 
FCBRL 
FCBCR 
5 

ORG 



EQU 
EQU 
EQU 
EQU 

lOOH 



FCB+1 5FILE NAME 

FCB+9 5FILE TYPE 

FCB+1 2 f CURRENT REEL # 

FCB+32 JNEXT REC * < 0-127) 



i SAVE OLD STACK AND SET UP NEW STACK 
I 

0100 210000 begin; LXI HfO JZERO HL 

0103 39 DAD SP JADD IN STACK 

0104 22AEF5 SHLD OLDSP ? SAVE STACK 

0107 31C8F5 LXI SP» STACK 5 DEFINE NEW STACK 

OlOA 210001 LXI H^BUFFER 

OlOD 22A9F5 SHLD BUFFP j MEMORY POINTER 

5 

5 BLOCK MOVE REST OF PROGRAM 



0110 


112A01 




LXI 


D.OLDST 


;OLD START 


0113 


2100F4 




LXI 


Hf START 


INEW START 


0116 


OlACOl 




LXI 


B»IBP-START f LENGTH 


0119 


lA 


LOOPI 


LDAX 


D 


f GET BYTE 


OllA 


77 




MOV 


MpA 


pMOVE to NEW 


OllB 


BE 




CMP 


M 


; CHECK MEMORY 


one 


C20000 




JNZ 





IQUIT? BAD 


OllF 


23 




INX 


H 


> INCREMENT 


0120 


13 




INX 


n 


; POINTERS 


0121 


OB 




DCX 


B 


JDECR COUNT 


0122 


78 




MOV 


ArB 


rSEE IF DONE 


0123 


Bl 




ORA 


C 


5 ALL MOVED? 


0124 


C21901 




JNZ 


LOOP 


5 NO 


0127 


C300F4 




JMP 


START 


;done 



$ ORIGINAL START OF PROGRAM 



F400 



OLDSTJ 
f 

ORG 



ORIGIN 



F400 C346F4 
F403 CD0BF4 
F406 2AAEF5 
F409 F9 
F40A C9 



start; 
finis; 



JMP 

CALL 

LHLD 

SPHL 

RET 



MAIN 5FINAL START 
CRLF 

OLDSP {ORIGINAL STACK 
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F40B 


3E0D 


f 

CRLFJ mi 


AfCR 


F40D 


CD12F4 


CALL 


PCHAR 


F410 


3E0A 


MVI 


AfLF 






r 

i OUTPUT A CHARACTER FROM A 


F412 


E5 


f 

PCHAR5 PUSH 


H 


F413 


D5 


PUSH 





F414 


C5 


PUSH 


B f SAVED 


F415 


0E02 


MVI 


CfTYPEF 


F417 


5F 


MOV 


Ef A 


F418 


CD0500 


CALL 


BDOS 


F41B 


CI 


POP 


B 


F41C 


Dl 


POP 


D 


F41D 


El 


POP 


H ? RESTORED 


F41E 


C9 


RET 








f 

; CARRIAGE RET > 


LINE FEED AND PRIi 


F41 F 




» 

PRINTC; CALL 


CRLF 






i 

} PRINT BUFFER 


UNTIL * FOUND 


F422 


E5 


PRINT J PUSH 


H 


F423 


0E09 


MVI 


CjPBUF 


F425 




CALL 


BDOS 


F428 


El 


POP 


H 


F429 


C9 


RET 








f GET NEXT BYTE 


FROM DISK BUFFER 


F42A 


3AACF5 


gnb; LDA 


IBP 


F42D 


FE80 


CP I 


80H 


F42F 


C236F4 


JNZ 


go 






y 

f READ ANOTHER 
} 


BUFFER 


F432 


Cn35F5 


CALL 


DISKR 


F435 


AF 


XRA 


A 






P 

5 READ THE BYTE 


AT BUFF-f REG A 


F436 


5F 


5 

go; MOV 


Ef A 


F437 


1600 


MVI 


D?0 


F439 


3C 


INR 


A 


F43A 


32ACF5 


STA 


IBP 






y POINTER IS INCREMENTED 






> SAVE THE CURRENT FILE ADDRESS 


F43D 


E5 


PUSH 


H 


F43E 


218000 


LXI 


HyBUFF 


F441 


19 


DAD 


D 


F442 


7E 


MOV 


A»M 






> BYTE IS IN THE ACCUMULATOR 






5 RESTORE FILE 


ADDRESS AND INCREMf 


F443 


El 


POP 


H 


F444 


23 


INX 


H 


F445 


C9 


RET 
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main: 

f 

'f READ BYTES FROM DISK AND PUT IN MEMORY 
f 



F44A 


CDD6F4 




CALL 


SETUP 


pSet up input f: 


F449 


3E80 




MVI 


Af 80H 




F44B 


32ACF5 




STA 


IBP 


? BUFFER POINTER 


F44E 


CD2AF4 


MAIN2* 


CALL 


6NB 


?GET A BYTE 


F45i 


E5 




PUSH 


H 




F452 


2AA9F5 




LHLD 


BUFFP 


? MEMORY POINTER 


F455 


77 




MOV 


m/a 


5 PUT BYTE IN 


F456 


23 




INX 


H 




F457 


22A9F5 




SHLD 


BUFFP 


5 SAVE POINTER 


F45A 


47 




MOM 


BrA 




F45B 


3EFF 




MVI 


AfOFFH 




F45D 


BD 




CMP 


L 


5L=0? 


F4SE 


C26AF4 




JNZ 


MAIN4 


vNO 


F461 


3A0700 




LDA 


7 


pFDOS 


F464 


D60A 




3UI 


10 


fCCP -1 


F466 


BC 




CMP 


H 


/TOO BIG? 


F467 


DA2FF5 




JC 


T00BI6 


p WON'T FIT 


F46A 


El 


> 

MAIN4: 


POP 


H 




F46B 


3AABF5 




LDA 


BFLAG 


5BINARY FILE? 


F46E 


B7 




ORA 


A 




F46F 


C24EF4 




JNZ 


MAIN2 


p YES 


F472 


78 




MOV 


AfB 


pGEt byte 


F473 


FEIA 




CP I 


EOF 




F475 


C24EF4 




JNZ 


MAIN2 


pNO 


F478 


2AA9F5 




LHLD 


BUFFP 


p POINTER 


F47B 


2B 


mains; 


DCX 


H 




F47C 


118AF5 


DONE ! 


LXI 


DsMESA 




F47F 


CD22F4 




CALL 


PRINT 




F482 


CDBDF4 




CALL 


OUTHL 


SPRINT IT 


F485 


1199F5 




LXI 


DjMESB 




F488 


CD22F4 




CALL 


PRINT 








r 

} CONVERT FILE 


LENGTH TO 


DECIMAL K 


F48B 


7C 


f 


MOV 


ArH 




F48C 


2600 




MVI 


HirO 


PLEADING FLAG 


F48E 


1664 




MVI 


D^lOO 




F490 


0E2F 


HM3,* 


MVI 


Cf'0'~i 




F492 


OC 


HM2J 


INR 


C 




F493 


92 




SUB 


D 


plOO/10 


F494 


D292F4 




JNC 


HM2 


pSTILL PLUS 


F497 


82 




ADD 


D 


p*ADD BACK 


F498 


47 




MOV 


BjA 


pSave remainder 


F499 


79 




MOV 


ApC 


pGET lOOS/TENS 






5 SUPPRESS LEADING ZEROS 




F4VA 


FE31 




CPI 


' 1 ' 


pLEss than 1? 


F49C 


D2A5F4 




JNC 


HM4 


pNO 


F49F 


7C 




MOV 


Af H 


5 check flag 


F4A0 


B7 




ORA 


A 


pZERO? 
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F4A1 


79 




MOV 


AyC 


5 RESTORE BYTE 


F4A2 


CAAAF4 




JZ 


HM5 


fIF LEADING 


F4A5 


CD12F4 


HM4J 


CALL 


PCHAR 


51ST» 2ND DIGIT 


F4AS 


26FF 




MVI 


H» OFFH 


fSET FLAG 


F4AA 


7A 


HM5: 


Moy 


AvB 




F4AEI 


D65A 




SUI 


90 


5100 TO 10 


F4Ari 


57 




MOM 


Di-A 




F4AE 


78 




MOV 


A?B 




F4AF 


B290F4 




JNC 


HM3 


yONCEMORE 


F4B2 


C630 




ADI 


'0' 


y ASCI I BIAS 


F4B4 


CB12F4 




CALL 


PCHAR 


STiR'Ti htgtt 


F4B7 


CD0BF4 




CALL 


CRLF 




F4BA 


C300F0 




JMP 


MONIT 


5 DONE 






> 

5 CONyERT BINARY IN HfL 


TO ASCII HEX 


F4BD 


4C 


outhl; 


MOV 


Ci'H 




F4BE 


CBC2F4 




CALL 


OUTHX 




F4C1 


4B 




MOV 


C 11 L 




F4C2 


79 


OUTHX; 


MOV 


AyC 




F4C3 


IF 




RAR 






F4C4 


IF 




RAR 






F4C5 


IF 




RAR 






F4C6 


IF 




RAR 






F4C7 


CDCBF4 




CALL 


HEXl 




F4CA 


79 




MOV 


AyC 




F4CB 


E60F 


HEXl J 


ANI 


OFH 


5 OUTPUT HEX BYTE 


F4CD 


C690 




ADI 


90H 




F4CF 


27 




BAA 




» INTEL DAA TRICK 


F4no 


CE40 




AC I 


40H 




F4n2 


27 




DAA 






F4D3 


C312F4 




JMP 


PCHAR 








p 

5 SETUP 


FILE 


ANB OPEN FOR INPUT 






5 CHECK 


FOR BINARY FILE 




F4D6 


AF 


> 

setup: 


XRA 


A 


5 ZERO 


F4D7 


32ABF5 




ST A 


BFLAG 


5 NOT BINARY FILE 


F4nA 


2A6500 




LHLB 


FCBFT 


5FILE TYPE 


F4DD 


7B 




MOV 


Af L 


5 1ST CHAR 


F4DE 


FE43 




CPI 


'C 




F4E0 


C200F5 




JNZ 


BINCH 


yNO 


F4E3 


7C 




MOV 


A»H 


f SECOND CHAR 


F4E4 


FE4F 




CPI 


'0' 




F4E6 


C200F5 




JNZ 


BINCH 


yNO 


F4E9 


3E1A 


□ PN2S 


MVI 


A J EOF 


ySET FLAG 


F4EB 


32ABF5 




STA 


BFLAG 








y SETUP 


FILE 


ANB OPEN FOR INPUT 


F4EE 


115C00 


i 

0PN3! 


LXI 


i:uFCB 




F4F1 


OEOF 




MVI 


Cf OPENF 




F4F3 


CD0500 




A L. L. 


BBOS 








} 

5 CHECK 


FOR ERRORS 




F4F6 


FEFF 


i 


CPI 


255 




F4F8 


CA0EF5 




JZ 


BABOPN 


yNO GOOD 
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5 

} OPEN IS OK 
5 



F4FB 


AF 




XRA 


A 




F4FC 


327C00 




STA 


FCBCR 




F4FF 


C9 




RET 










5 

f B FOR 


THIRD 


ARGUMENT i 


MEANS BINARY FTLF 


F500 


jC X U J.< V v 


r 

binch: 


LXI 


H > AI1H 




F503 


7E 




Moy 


A > M 




r *jv^ 


FAS7 




ANI 


571-1 




F506 


FE42 




CP I 


' B ' 




F508 


C2EEF4 




JNZ 


0PN3 


5 NOT BINARY 


F5QB 


C3E9F4 




JMP 


0PN2 


f BINARY 






i BAD OPEN 






F50E 


215D00 


BADOPN! 


LXI 


H y FCBFN 


5 1ST CHAR 


F511 


7E 




MOV 


A»M 


KGET IT 


F512 


FE20 




CP I 




5FILE NAME? 


F'^ii A 
r sj J. *T 






JZ 






F517 


213F24 




LXI 


Hf '?*' 


5SET UP FOR PRINT 


F51A 


226800 




SHLD 


FCBRL 


»USE INPUT FILENAME 


F51II 


115D00 




LXI 


Df FCBFN 


^FILENAME 


F520 


CD22F4 




CALL 


PRINT 




r Ztj£.C^ 






JMP 


FINIS 


» Ol 1 T T 
f UU X 1 






5 

NONAHEJ 


LXI 


DjMESI 






w jj A r r *t 


N0NAM2: 


CALL 


PRINTC 




*" 


1^ u Vr w 1 ^ 


5 


JMP 


FINIS 




r tj^r 


1 1 

J. X / rir \J . 


toobig; 


LXI 


D»MES4 




F532 


p -I -3 Of.- 1=1 




JMP 


N0NAM2 








f READ 


DISK FILE RECORD 




F535 


ES 


diskr: 


PUSH 


H 




F536 


D5 




PUSH 


D 




F537 


C5 




PUSH 


B 




r \j<jQ 






LXI 


D?FCB 




F53B 


0E14 




MVI 


CfREADF 




F53n 


cno5oo 




CALL 


BDOS 




F540 


CI 




POP 


B 




F541 


Bl 




POP 


D 




F542 


El 




POP 


H 




F543 


B7 




ORA 


A 


S PHPPk" CnC' FP?DO 


F544 


C8 




RZ 




5 OK 






r 

t HAY BE EOF 






F545 


FEOl 


f 


CPI 


1 




F547 


CAS3F5 




JZ 


FEND 


fEOF 






7 

} INCORRECT FI 


LE NAME 




F54A 


116FF5 


f 


LXI 


D»MES2 




F54D 


CD1FF4 




CALL 


PRINTC 




F550 


C303F4 




JMP 


FINIS 
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} 

i FOUND DISK EOF 



F553 


2AA9F5 fend; 


LHLD 


BUFFP 


?GET POINTER 


F556 


3AABF5 


LDA 


BFLAG 


JCOM FILE? 


F559 


B7 


ORA 


A 




F55A 


C27BF4 


JN2 


MAINS 


SYES 


F55D 


361A 


mi 


M»EOF 


/PUT EOF 


F55F 


C37CF4 


JMP 


DONE 






y 

J STORAGE AREA 






F562 


4E6F206669MES1; 


DB 


'No file name*' 


F56F 


4469736B20MES2; 


DB 


'Disk 


error*' 


F57A 


46696C6520MES4J 


DB 


'File 


is too bis*' 


F58A 


4C61737420MESA! 


BB 


' Last 


addressJ *' 


F599 


206865782CMESB: 


DB 


' hex J 


Blocks: *' 


F5A9 


0001 BUFFP; 


DU 


BUFFER 


/POINTER 


F5AH1 


f 

BFLAGJ 


OS 


1 


/BINARY FLAG 


F5AC 


IBP; 


DS 




5 INPUT BUFF POINTER 




> 
> 


STACK 


AREA 




F5AE 


> 

OLDSPI 


DS 


2 


/OLD STACK 


F5B0 




DS 


24 


/STACK SPACE 




STACK? 








F5C8 


> 


END 







One of the advantages of FETCH is that it is considerably smaller than 
DDT or SID. In addition, the decimal number of blocks to be saved and the 
last address of the program are given. FETCH is executed just hke the 
debugger. 

A>FETCH <f ilen3ise>.<eHtension> 

The CP/M system loads FETCH at 100 hex and then branches to it. The 
instructions at the beginning of FETCH are used to relocate the rest of the 
program into a preselected memory area. A jump is then made to the relo- 
cated FETCH. 

FETCH loads the selected disk file into memory starting at 100 hex. 
An ASCII file is copied up to the lA end-of-file mark. Typical extension 
names include the following. 



ASM 


(assembly language) 


PAS 


(Pascal) 


FOR 


(FORTRAN) 


BAS 


(BASIC) 


HEX 


(hex-encoded binary) 


TEX 


(text formatter) 


LIB 


(library) 


MAC 


(assembly language) 
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Executable binary files will have a file extension of COM; the entire file will 
be copied in this case. If a nonexecutable binary file is loaded, an additional 
argument of B (for binary) must be given. 

FETCH SORT.REL B 
Examples of executable binary files are 

REL (relocatable) 
INT (intermediate) 

Relocatable files generated by the Microsoft assembler, and the FORTRAN, 
COBOL, and BASIC compiler are of this type. Intermediate files are pro- 
duced by CBASIC. 

After the disk file* is loaded, FETCH prints two numbers. One number 
is the memory address of the end of the file expressed in hex. The other 
number is the size of the file. The number of 256-byte blocks is printed, 
in decimal. 

Type up the program given in the listing. Assemble it and load it into 
memory with the debugger 

A>DDT FETCH. HEX 

The debugger will load the move routine, the first part of FETCH, into 
memory at 100 hex. The main part of the program, however, will be loaded 
at the address of ORIGIN, OF400 hex in this case. Use the debugger to move 
the main part of FETCH back down to the beginning of the user area. 

MF400 F5FF 12A 

Now, return to the CP/M system with a control-C and save the combination 
of the move program and the main part of FETCH. 

A>SAVE 2 FETCH, COM 
FETCH is now ready for use. 
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APPENDIX A 

The ASCII Character Set 



The ASCII character set is listed in numerical order with the corresponding 
decimal, hexadecimal, and octal values. The control characters are indicated 
with a caret (a). For example, the horizontal tab (HT) is formed with a 
control-I. 



decia hex octal 



NUL 





00 


000 


"@ 


Nul 1 


1= 


0*T 


T \/ 


1 00 


SOH 


1 


01 


001 


"A 




A 
M 


AS 




1 f)1 


STX 


2 


02 


002 


"B 




ts 


OO 






ETX 


3 


03 


003 


"*C 


End of "fcewt 


r 




43 


103 


EOT 


4 




004 


■^D 


End of transmission 


D 


68 


44 


104 


ENQ 


5 


05 


005 


"E 


Enaui ra 


E 


69 


45 


105 


ACK 


6 


06 


006 


"p 


Acknowledae 


F 


70 


46 


106 


BEL 


7 


07 


007 


"B 


Bell 


G 


71 


47 


107 






















BS 


8 


08 


010 


"H 


B3cl<.space 


H 


72 


48 


110 


HT 


9 


09 


Oil 


"I 


Horizontal tab 


I 


73 


49 


111 


LF 


10 


OA 


012 


"J 


Line feed 


J 


74 


4A 


112 


VT 


11 


OB 


013 


"K 


Vertical tab 


K 


75 


4B 


113 


FF 


12 


OC 


014 


"L 


Form feed 


L 


76 


4C 


114 


CR 


13 


OD 


015 


"M 


Carriage return 


M 


77 


40 


115 


SO 


14 


OE 


016 


"N 


Shift out 


N 


78 


4E 


116 


SI 


15 


OF 


017 


"0 


Shift in 





79 


4F 


117 






















DLE 


16 


10 


020 




Data link escape 


P 


80 


50 


120 


DCl 


17 


11 


021 


-G 


Device control 1 


Q 


81 


51 


121 


DC2 


18 


12 


022 


"R 


Device control 2 


R 


82 


52 


122 


DC3 


19 


13 


023 


"S 


Device control 3 


S 


83 


53 


123 


0C4 


20 


14 


024 


"T 


Device control 4 


T 


84 


54 


124 


NAK 


21 


15 


025 


"U 


Negative acknowledsEe 


U 


85 


55 


125 


SYN 


22 


16 


026 


-V 


Synchronous idle 


V 


86 


56 


126 


ETB 


23 


17 


027 


"W 


End transmission block 


U 


87 


57 


127 




















CAN 


24 


18 


030 


"X 


Cancel 


X 


88 


58 


130 


EM 


25 


19 


031 


"Y 


End of medium 


Y 


89 


59 


131 


SUB 


26 


lA 


032 


"Z 


Substitute 


Z 


90 


5A 


132 


ESC 


27 


IB 


033 




Escape 


C 


91 


5B 


133 


FS 


28 


IC 


034 


"\ 


File separator 


\ 


92 


5C 


134 


GS 


29 


ID 


035 




Group separator 


3 


93 


5D 


135 


R8 


30 


IE 


036 




Record separator 




94 


5E 


136 


US 


31 


IF 


037 




Unit separator 




95 


5F 


137 























253 



254 8080/Z-80 ASSEMBLY LANGUAGE 



ssssss 






~""~~~~~~~~™~"""" 


sr = 


— 


==== 


=—=== 


SP 


32 


20 


040 Space 


\ 


96 


60 


140 


j 


33 


21 


041 


3 


97 


61 


141 




34 


22 


042 


b 


98 


62 


142 


# 


35 


23 


043 


c 


99 


63 


143 


$ 


36 


24 


044 


d 


100 


64 


144 


X 


37 


25 


045 


e 


101 


65 


145 


s 


38 


26 


046 


f 


102 


66 


146 




39 


27 


047 


SI 


103 


67 


147 


















< 


40 


28 


050 


h 


104 


68 


150 


> 


41 


29 


051 


i 


105 


69 


151 


* 


42 


2A 


052 


J 


106 


6ft 


152 


+ 


43 


2B 


053 


k 


107 


6B 


153 


f 


44 


2C 


054 


1 


108 


6C 


154 


~ 


45 


2n 


055 


m 


109 


6D 


155 


* 


46 


2E 


056 


n 


110 


6E 


156 


/ 


47 


2F 


057 


o 


111 


6F 


157 





48 


30 


060 


== 
p 


====== 

112 


____ 
70 


===== 
160 


1 


49 


31 


061 


B 


113 


71 


161 


2 


50 


32 


062 


r 


114 


72 


162 


3 


51 


33 


063 


s 


115 


73 


163 


4 


52 


34 


064 


t 


116 


74 


164 


5 


S3 


35 


065 


u 


117 


75 


165 


6 


54 


36 


066 


V 


118 


76 


166 


7 


55 


37 


067 


N 


119 


77 


167 


















8 


56 


38 


070 


X 


120 


78 


170 


9 


57 


39 


071 


H 


121 


79 


171 


« 
* 


58 


3A 


072 


Z 


122 


7A 


172 




59 


38 


073 


< 


123 


7B 


173 


< 


60 


3C 


074 


t 


124 


7C 


174 




61 


3D 


075 


> 


125 


7D 


175 


> 


62 


3E 


076 




126 


7E 


176 


7 


63 


3F 


077 


DEL 127 


7F 


177 



APPENDIX B 

A 64K Memory Map 



The 8080 and Z-80 microprocessors can directly address 64K bytes of 
memory. The memory area is mapped out in the chart that follows. Each entry 
represents a 256-byte block. The high-order byte of the address is given in hex 
then in octal. For example, the first entry of the second column is: 

20 040 32 

This represents an address range of 2000 to 2FFF hex, or 040-000 to 040- 
777 octal. The third column gives the decimal number of IK blocks. The fourth 
column is the decimal number of 256-byte blocks starting at the address 100 
hex. As an example, suppose that a CP/M program runs from 100 hex to 3035 
hex. The 30 hex entry in the table shows that the program contains 48 decimal 
blocks of 256-b3d;e size. The program can be saved with the CP/M command: 

A>SAVE 48 filename 

As another example, if you have two, 16K memory boards starting at 
address zero, then your top of memory is located at address 7FFF hex. 



255 



256 8080/Z-80 ASSEMBLY LANGUAGE 



iex 


Oct 


K 


Bl 


Hex 


Oct 


K 


Bl 




Oct 


K 


Bl 


Hex 


Oct 


K 


Bl 


=== 


===== 


== 


==== 






____ 


; === = 


===== 


=== 


===== 


: = = = : 


===== 


=== 


==== 


00 


000 







OA 


{J^v 




32 


40 


100 




64 


60 


140 




96 


01 


001 




1 


n -6 
d X 






33 


41 


101 




65 


61 


141 




97 


02 


002 




2 








34 


42 


102 




66 


62 


142 




98 


03 


003 


1 


3 




043 


9 


35 


43 


103 


17 


67 


63 


143 


25 


99 


SKSS. 




"*~ 


====* 






:== 


==== 


===== 


===== 








===== 


=== 




04 


004 




4 




f\ A A 




36 


44 


104 




68 


64 


144 




100 


05 


005 




5 


25 


V*ttJ 




37 


45 


105 




69 


65 


145 




101 


06 


006 




6 


z 
jdO 


046 




38 


46 


106 




70 


66 


146 




102 


07 


007 


2 


7 






10 


39 


47 


107 


18 


71 


67 


147 


26 


103 














'== 


= = = = ! 




===== 


=== 


SET 


===== 


===== 


=== 


===== 


08 


010 




8 


2B 


050 




40 


48 


110 




72 


68 


150 




104 


09 


Oil 




9 


29 


051 




41 


49 


111 




73 


69 


151 




105 


OA 


012 




10 








42 


4A 


112 




74 


6A 


152 




106 


OB 


013 


3 


11 






11 


43 


4B 


113 


19 


75 


6B 


153 


27 


107 






===== 






■== 


===== 


===== 


===== 


! = = 




! = = = = 


===== 


=== 


==== 


OC 


014 




12 


2C 


054 




44 


4C 


114 




76 


6C 


154 




108 


OD 


015 




13 


2D 


055 




45 


40 


115 




77 


6D 


155 




109 


OE 


016 




14 


2E 


056 




46 


4E 


116 




78 


6E 


156 




110 


OF 


017 


4 


15 


2F 


057 


12 


47 


4F 


117 


20 


79 


6F 


157 


28 


111 










== 


====: 


===== 


===== 


=== 


s = = zs: 




sssassss 


===== 




10 


020 




16 


30 


060 




48 


50 


120 




80 


70 


160 




112 


11 


021 




17 


31 


061 




49 


51 


121 




81 


71 


161 




113 


12 


022 




18 


32 


062 




50 


52 


122 




82 


72 


162 




114 


13 


023 


5 


19 


33 


063 


13 


51 


53 


123 


21 


83 


73 


163 


29 


115 






====: 










===== 


==: 






==== 


===== 


===== 


14 


024 




20 


34 


064 




52 


54 


124 




84 


74 


164 




116 


15 


025 




21 


35 


065 




53 


55 


125 




85 


75 


165 




117 


16 


026 




22 


36 


066 




54 


56 


126 




86 


76 


166 




118 


17 


027 


6 


23 


37 


067 


14 


55 


57 


127 


22 


87 


77 


167 


30 


119 








===== 








===== 




===:= = 


=== 


====: 


: ===:: 


===== 


:=== 


===== 


IB 


030 




24 


38 


070 




56 


58 


130 




88 


78 


170 




120 


19 


031 




25 


39 


071 




57 


59 


131 




89 


79 


171 




121 


lA 


032 




26 


3A 


072 




58 


5A 


132 




90 


7A 


172 




122 


IB 


033 


7 


27 


3B 


073 


15 


59 


5B 


133 


23 


91 


7B 


173 


31 


123 


































IC 


034 




28 


3C 


074 




60 


5C 


134 




92 


7C 


174 




124 


ID 


035 




29 


30 


075 




61 


5D 


135 




93 


7D 


175 




125 


IE 


036 




30 


3E 


076 




62 


5E 


136 




94 


7E 


176 




126 


IF 


037 


8 


31 


3F 


077 


16 


63 


5F 


137 


24 


95 


7F 


177 


32 


127 
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Maw 


UCXr 


K* 
l\ 


ttl 






it 


JPX 


neK 




l\ 


n 1 

D X 




UC b 


l\ 


I^X 




Odd 




1 

M.&.0 


HV/ 


4S.*? V 




1 AO 

XO w 


PA 






1 oo 

X y it 










81 






1 no 


f*l J. 






JLU it 


n 


X 




X 7 O 


r 1 

Cl X 


"XA 1 

w>^ X 






82 


202 




130 


A2 


242 




162 


C2 


302 




194 


E2 


342 




226 


83 


203 


33 


131 


A3 


243 


41 


163 


C3 


303 


49 


195 


E3 


343 


57 


227 




































204 




J. 0£. 








XO*? 


U*f 






1 Vo 


C A 


It A A 






85 


205 












Xo«3 








X y / 


cu 


HA^ 






86 


206 




134 


A6 


246 




166 


C6 


306 




198 


E6 


346 




230 


87 


207 34 


135 


A7 


247 


42 


167 


C7 


307 


50 


199 


E7 


347 


58 


231 


nn 
oo 


210 






Ho 






Xoo 




OX \^ 






CO 










211 












XO 7 


PQ 


OX X 




OA 1 
^sj X 


c.y 


1 S 1 
X vJ X 






8A 


212 




138 


AA 


252 




170 


CA 


312 




202 


EA 


352 




234 


8B 


213 


35 


139 


AB 


253 


43 


171 


CB 


313 


51 


203 


EB 


353 


59 


235 


8C 


214 




140 


AC 


254 




172 


cc 


314 




204 


EC 


354 




236 


8D 


215 




141 


AD 


255 




173 


CD 


315 




205 


ED 


355 




237 


8E 


216 




142 


AE 


256 




174 


CE 


316 




206 


EE 


356 




238 


8F 217 


36 


143 


AF 


257 


44 


175 


CF 


317 


52 


207 


EF 


357 


60 


239 


90 220 






oU 






X /o 


Us) 








r 


o6U 




<;40 


91 


221 




1 


£> X 






X // 


Li X 








r 1 








92 


222 




146 


B2 


262 




178 


D2 


322 




210 


F2 


362 




242 


93 


223 


37 


147 


B3 


263 


45 


179 


D3 


323 


53 


211 


F3 


363 


61 


243 


94 


224 




J. "vO 


sfH 






XOv 


ri^ 






<£: X ^ 


r ^ 


HA A 






95 


225 




1 AO 




DA'S? 




xox 


113 








r ij 








96 


226 




150 


B6 


266 




182 


06 


326 




214 


F6 


366 




246 


97 


227 


38 


151 


B7 


267 


46 


183 


D7 


327 


54 


215 


F7 


367 


62 


247 


98 


230 




152 


B8 


270 




184 


D8 


330 




216 


F8 


370 




248 


99 


231 




153 


B9 


271 




185 


D9 


331 






F9 








9A 


232 




154 


BA 


272 




186 


DA 


332 




218 


FA 


372 




250 


9B 


233 


39 


155 


BB 


273 


47 


187 


DB 


333 


55 


219 


FB 


373 


63 


251 


9C 


234 




156 


BC 


274 




188 


DC 


334 




220 


FC 


374 




252 


9D 


235 




157 


BD 


275 




189 


DD 


335 




221 


FD 


375 




253 


9e: 


236 




158 


BE 


276 




190 


DE 


336 




222 


FE 


376 




254 


9F 


237 


40 


159 


BF 


227 


48 


191 


DF 


337 


56 


223 


FF 


377 


64 


255 



APPENDIX C 

The 8080 Instruction Set 
(Alphabetic) 



The 8080 instruction set is listed alphabetically with the corresponding 
hexadecimal code. The following representations apply. 

nn 8-bit argument 
nnnn 16-bit argument 





Mnemonic 




Hoy 


Mnemonic 


CE nn 


ACI 


nn 


2F 




CMA 




8F 


ADC 


A 


3F 




CMC 




88 


ADC 


B 


BF 




CMP 


A 


on 

89 


ADC 


C 


DO 




CMP 


B 


8A 


ADC 


D 


B9 




CMP 


C 


8B 


ADC 


E 


BA 




CMP 


D 


8C 


ADC 


H 


BB 




CMP 


E 


8D 


ADC 


L 


BC 




CMP 


H 


8E 


ADC 


M 


BD 




CMP 


L 


87 


ADD 


A 


BE 




CMP 


M 


80 


ADD 


B 


D4 


nnnn 


CNC 


nnnn 


81 


ADD 


C 


C4 


nnnn 


CNZ 


nnnn 


82 


ADD 


D 


F4 


nnnn 


CP 


nnnn 


83 


ADD 


E 


EC 


nnnn 


CPE 


nnnn 


84 


ADD 


H 


FE 


nn 


CPI 


nn 


85 


ADD 


L 


E4 


nnnn 


CPO 


nnnn 


86 


ADD 


M 


CC 


nnnn 


CZ 


nnnn 


C6 nn 


ADI 


nn 


27 




DAA 




A7 


ANA 


A 


09 




DAD 


B 


AO 


ANA 


B 


19 




DAD 


D 


Al 


ANA 


C 


29 




DAD 


H 


A2 


ANA 


D 


39 




DAD 


SP 


A3 


ANA 


E 


3D 




DCR 


A 


A4 


ANA 


H 


05 




OCR 


B 


A5 


ANA 


L 


OD 




DCR 


C 


A6 


ANA 


M 


15 




DCR 


D 


E6 nn 


ANI 


nn 


ID 




DCR 


E 


CD nnnn 


CALL 


nnnn 


25 




DCR 


H 


DC nnnn 


CC 


nnnn 


2D 




DCR 


L 


FC nnnn 


CM 


nnnn 


35 




DCR 


M 


258 



APPENDIX C 259 





Hex 


Mnemonic 


Hex 


Mnemonic 


OB 




DCX 


B 


43 


MOV 


B,E 


IB 




DCX 


D 


44 


MOV 


B,H 


2B 




DCX 


H 


45 


MOV 


B,L 


3B 




DCX 


SP 


46 


MOV 


B,M 


F3 




DI 




4F 


MOV 


C,A 


FB 




EI 




48 


MOV 


C,B 


76 




TIT m 

JiLT 




49 


MOV 


C,C 


DB 


nn 


I'M 

iJN 


nn 


4A 


MOV 


C,D 


3C 




UN it 


A 

A 


4B 


MOV 




04 




T\TT> 


r> 
D 


4C 


MOV 


C,H 


OC 




T"MT? 

llNxv 




4D 


MOV 


T 

0,L 


14 




TTvTT? 


JU 


4E 


MU V 


/~i -ii/f 
0,M 


IC 




TMP 




57 


MU V 


D,A 


24 




TTsJT? 

liNiA. 


n 


50 


MU V 


1 \ TT) 

U,ii 


2C 




liN JX 


Li 


51 


MU V 


D,C 


34 




UN It 


Alt 
M 


52 


MOV 


D,D 


03 




TMV 

UNA 


r) 
£> 


53 


MOV 


D,E 


13 




Tivrv 

UNA 


U 


54 


MOV 


D,H 


23 




UNA 


TT 

rl 


55 


MOV 


D,L 


33 




TTVTV 

UNA 


CD 


56 


MOV 


D,M 


DA 


nnnn 




nnnn 


5F 


MOV 


E,A 


FA 


nnnn 


nv/i 


nnnn 


58 


MOV 


E,B 


C3 


nnnn 


JMr 


nnnn 


59 


MOV 


E,C 


D2 


nnnn 


JJNC 


nnnn 


5A 


MOV 


E,D 


C2 


nnnn 


JJN^ 


nnnn 


5B 


MOV 


E,E 


F2 


nnnn 


I'D 

Jr 


nnnn 


5C 


MOV 


E,H 


EA 


nnnn 




nnnn 


5D 


MOV 


E,L 


E2 


nnnn 


JrU 


nnnn 


5E 


MOV 


E,M 


CA 


nnnn 


JZ 


nnnn 


67 


MOV 


H,A 


3A 


nnnn 


LDA 


nnnn 


60 


MOV 


H,B 


OA 




LDAX 


B 


61 


MOV 


H,C 


lA 




LDAX 


D 


62 


MOV 


H,D 


2A 


nnnn 


LHLD 


nnnn 


63 


MOV 


H,E 


01 


nnnn 


LXI 


B, nnnn 


64 


MOV 


H,H 


11 


nnnn 


LXI 


D, nnnn 


65 


MOV 


H,L 


21 


nnnn 


LXI 


H, nnnn 


66 


MOV 


H,M 


31 


nnnn 


T VT 

LaI 


SP, nnnn 


6F 


MOV 


L,A 


7F 




MU V 


A A 

A, A 


68 


MOV 


L,B 


78 




IViU V 


A T3 


69 


MOV 


L,C 


79 




MU V 




6A 


MOV 


L,D 


7A 




MOV 




6B 


iViU V 


T T? 


7B 




MOV 


A,E 


6C 


MOV 


L,H 


7C 




MOV 


A,H 


6D 


MOV 


L,L 


7D 




MOV 


A,L 


6E 


MOV 


L,M 


7E 




MOV 


A,M 


77 


MOV 


M,A 


47 




MOV 


B,A 


70 


MOV 


M,B 


40 




MOV 


B,B 


71 


MOV 


M,C 


41 




MOV 


B,C 


72 


MOV 


M,D 


42 




MOV 


B,D 


73 


MOV 


M,E 
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Hex Mnemonic 



74 




MOV 


M,H 


75 




MOV 


M,L 


3E 


nn 


MVI 


A, nn 


06 


nn 


MVI 


B, nn 


OE 


nn 


MVI 


C, nn 


16 


nn 


MVI 


D, nn 


IE 


nn 


MVI 


E, nn 


26 


nn 


MVI 


H, nn 


2E 


nn 


MVI 


L, nn 


36 


nn 


MVI 


M, nn 


00 




NOP 




B7 




ORA 


A 


BO 




ORA 


B 


Bl 




ORA 


C 


B2 




ORA 


D 


B3 




ORA 


E 


B4 




ORA 


H 


B5 




ORA 


L 


B6 




ORA 


M 


F6 


nn 


ORI 


nn 


D3 


nn 


OUT 


nn 


E9 




PCHL 




CI 




POP 


B 


Dl 




POP 


D 


El 




c POP 


H 


Fl 




POP 


PSW 


C5 




PUSH 


B 


D5 




PUSH 


D 


E5 




PUSH 


H 


F5 




PUSH 


PSW 


17 




RAL 




IF 




RAR 




D8 




RC 




C9 




RET 




07 




RLC 




F8 




RM 




DO 




RNC 




CO 




RNZ 




FO 




RP 




E8 




RPE 




EO 




RPO 




OF 




RRC 




C7 




RST 






Hex Mnemonic 



CF 




RST 


1 


D7 




RST 


2 


DF 




RST 


3 


E7 




RST 


4 


EF 




RST 


5 


F7 




RST 


6 


bb 




RST 


7 


Co 




RZ 




yr 




SBB 


A 






SEE 


B 


99 




SBB 


C 


9A 




SBB 


D 


9B 




SBB 


E 


90 




SBB 


H 


9D 




SBB 


L 


9E 




SBB 


M 


DE 


nn 


SBI 


nn 


22 


nnnn 


SHLD 


nnnn 


F9 




SPHL 




32 


nnnn 


STA 


nnnn 


37 




STC 




02 




STAX 


B 


12 




STAX 


D 


97 




SUB 


A 


90 




SUB 


B 


91 




SUB 


C 


92 




SUB 


D 


93 




SUB 


E 


94 




SUB 


H 


95 




SUB 


L 


96 




SUE 


M 


D6 


nn 


SUI 


nn 


EB 




XCHG 




AF 




XRA 


A 


A8 




XRA 


B 


A9 




XRA 


C 


AA 




XRA 


D 


AB 




XRA 


E 


AC 




XRA 


H 


AD 




XRA 


L 


AE 




XRA 


M 


EE 


nn 


XRI 


nn 


E3 




XTHL 





APPENDIX D 

The 8080 Instruction Set 
(Numeric) 



The 8080 instruction set is listed alphabetically with the corresponding 
hexadecimal code. The following representations apply. 

nn 8-bit argument 
nnnn 16 -bit argument 





xiex 


Mnemonic 




Hex 


Mnemonic 


00 




NOP 


IE 


nn 


MVI E nn 


01 


nnnn 


LXI B, nnnn 


IF 




RAR 


02 




STAX B 


20 




(not used) 


03 




INX B 


21 


nnnn 


LXI H, nnnn 


04 




INR B 


22 


nnnn 


SHLD nnnn 


05 




DCR B 


23 




INX H 


06 


nn 


MVI B, nn 


24 




INR H 


07 




RLC 


25 




DCR H 


08 




(not used) 


26 


nn 


MVI H, nn 


09 




DAD B 


27 




DAA 


OA 




LDAX B 


28 




(not used) 


OB 




DCX B 


29 




DAD H 


OC 




INR C 


2A 


nnnn 


LHLD nnnn 


OD 




DCR C 


2B 




DCX H 


OE 


nn 


MVI C, nn 


2C 




INR L 


OF 




RRC 


2D 




DCR L 


10 




(not used) 


2E 


nn 


MVI L, nn 


11 


nnnn 


LXI D, nnnn 


2F 




CMA 


12 




STAX D 


30 




(not used) 


13 




INX D 


31 


nnnn 


LXI SP, nnnn 


14 




INR D 


32 


nnnn 


STA nnnn 


15 




DCR D 


33 




INX SP 


16 


nn 


MVI D, nn 


34 




INR M 


17 




RAL 


35 




DCR M 


18 




(not used) 


36 


nn 


MVI M,nn 


19 




DAD D 


37 




STC 


lA 




LDAX D 


38 




(not used) 


IB 




DCX D 


39 




DAD SP 


IC 




INR E 


3A 


nnnn 


LDA nnnn 


ID 




DCR E 


3B 




DCX SP 



261 
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Hex Mnemonic 



3C 


INR 


A 


3D 


DCR 


A 


3E nn 


MVI 


A, nn 


3F 


CMC 




40 


MOV 


B,B 


41 


MOV 


B,C 


42 


MOV 


B,D 


43 


MOV 


B,E 


44 


MOV 


B,H 


45 


MOV 


B,L 


46 


MOV 


B,M 


47 


MOV 


B,A 


48 


MOV 


C,B 


49 


MOV 


C,C 


4A 


MOV 


C,D 


4B 


MOV 


C,E 


4C 


MOV 


C,H 


4D 


MOV 


C,L 


4E 


MOV 


C,M 


4F 


MOV 


C,A 


50 


MOV 


D,B 


51 


MOV 


D,C 


52 


MOV 


D,D 


53 


MOV 


D,E 


54 


MOV 


D,H 


55 


MOV 


D,L 


56 


MOV 


D,M 


57 


MOV 


D,A 


58 


MOV 


E,B 


59 


MOV 


E,C 


5A 


MOV 


E,D 


5B 


MOV 


E,E 


5C 


MOV 


E,H 


5D 


MOV 


E,L 


5E 


MOV 


E,M 


5F 


MOV 


E,A 


60 


MOV 


H,B 


61 


MOV 


H,C 


62 


MOV 


H,D 


63 


MOV 


H,E 


64 


MOV 


H,H 


65 


MOV 


H,L 


66 


MOV 


H,M 


67 


MOV 


H,A 


68 


MOV 


L,B 


69 


MOV 


L,C 


6A 


MOV 


L,D 


6B 


MOV 


L,E 


6C 


MOV 


L,H 



Hex Mnemonic 



6D 


MOV 


L,L 


6E 


MOV 


L,M 


6F 


MOV 


L,A 


70 


MOV 


M,B 


71 


MOV 


M,C 


72 


MOV 


M,D 


73 


MOV 


M,E 


74 


MOV 


M,H 


75 


MOV 


M,L 


76 


HLT 




77 


MOV 


M,A 


78 


MOV 


A,B 


79 


MOV 


A,C 


7A 


MOV 


A,D 


7B 


MOV 


A,E 


7C 


MOV 


A,H 


7D 


MOV 


A,L 


7E 


MOV 


A,M 


7F 


MOV 


A,A 


80 


ADD 


B 


81 


ADD 


C 


82 


ADD 


D 


83 


ADD 


E 


84 


ADD 


H 


85 


ADD 


L 


86 


ADD 


M 


87 


ADD 


A 


88 


ADC 


B 


89 


ADC 


C 


8A 


ADC 


D 


8B 


ADC 


E 


8C 


ADC 


H 


8D 


ADC 


L 


8E 


ADC 


M 


8F 


ADC 


A 


90 


SUB 


B 


91 


SUB 


c 


92 


SUB 


D 


93 


SUB 


E 


94 


SUB 


H 


95 


SUB 


L 


96 


SUB 


M 


97 


SUB 


A 


98 


SBB 


B 


99 


SBB 


C 


9A 


SBB 


D 


9B 


SBB 


E 


9C 


SBB 


H 


9D 


SBB 


L 
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Hex 


Mnemonic 


9E 




oJ5o 


iVl 


9F 






A 
A 


AO 




A M A 


p 

ID 


Al 




AM A 




A2 




AM A 


u 


A3 




ANA 




A4 




AM A 


11 


A5 




AM A 


T 
Ij 


A6 




AM A 


iVl 


A7 




A M A 


A 

A 


A8 




AKA 


a 


A9 




VT? A 


r\ 
\j 


AA 




AKA 




AB 




VD A 

AKA 


hi 


AC 




AKA 


T T 

n 


AD 




XRA 


L 


AE 




XRA 


M 


AF 




XRA 


A 


BO 




ORA 


B 


Bl 




ORA 


C 


B2 




ORA 


D 


B3 




ORA 


E 


B4 




ORA 


H 


B5 




ORA 


L 


B6 




OKA 


M 


B7 




UKA 


A 

A 


B8 




OMr 


■rt 

a 


B9 








BA 




L-lVir 


L) 


BB 




l>Mr 




BC 




UlVljT 


TT 
11 


BD 




L-iVlr 


Li 


BE 




PA/TP 


iVl 


BF 






A 

A 


CO 








CI 




PHP 


£> 


C2 


nnnn 


TNT 7 


nnnn 


C3 


nnnn 


JMP 


nnnn 


C4 


nnnn 


CNZ 


nnnn 


C5 




PUSH 


B 


C6 


nn 


ADI 


nn 


C7 




RST 





C8 




RZ 




C9 




RET 




CA 


nnnn 


JZ 


nnnn 


CB 




(not used) 


CC 


nnnn 


CZ 


nnnn 


CD 


nnnn 


CALL 


nnnn 


CE 


nn 


ACI 


nn 



Hex Mnemonic 



ur 




Rbl 


1 


UU 








Ul. 




POP 


D 


no 


nnnn 


JNC 


nnnn 


UO 


nn 


OUT 


nn 


T\A 
1J4 


nnnn 


CNC 


nnnn 


UO 




PUSH 


D 


UK) 


nn 


SUI 


nn 


JJ / 




RST 


2 


Do 




RC 




T\Ck 




(not used) 


JJA 


nnnn 


JC 


nnnn 


uB 


nn 


IN 


nn 


DC 


nnnn 


CC 


nnnn 


DD 




(not used) 


DE 


nn 


SBI 


nn 


DF 




RST 


3 


EG 




RPO 




El 




POP 


H 


E2 


nnnn 


JPO 


nnnn 


E3 




XTHL 




E4 


nnnn 


CPO 


nnnn 


E5 




PUSH 


H 


E6 


nn 


ANI 


nn 


E7 




RST 


4 


E8 




RPE 




E9 




PCHL 




EA 


nnnn 


JPE 


nnnn 


EjD 




XCHG 






nnnn 


CPE 


nnnn 


i?ini 
JliU 




(not used) 


titU 


nn 


XRI 


nn 






RST 


5 


r U 




RP 




r X 




POP 


PSW 


r A 


nnnn 


JP 


nnnn 


r o 




DI 




r4 


nnnn 


CP 


nnnn 


r 




PUSH 


PSW 


r b 


nn 


ORI 


nn 


FY 




RST 


6 


F8 




RM 




F9 




SPHL 




FA 


nnnn 


JM 


nnnn 


FB 




EI 




FC 


nnnn 


CM 


nnnn 


FD 




(not used) 


FE 


nn 


CPI 


nn 


FF 




RST 


7 



APPENDIX E 

The Z-80 Instruction Set 
(Alphabetic) 



The Zilog Z-80 instruction set is listed alphabetically with the corresponding 
hexadecimal values. The following representations apply. 

nn 8-bit arguments 

nnnn 16-bit arguments 

dd 8-bit signed displacement 

* instructions common to the 8080 



Hex 




Mnemonic 


Hex 




Mnemonic 


8E 


* 


ADC 


A,(HL) 


19 


* 


ADD 


HL,DE 


DD 8Edd 




ADC 


A,(IX+dd) 


29 


* 


ADD 


HL,HL 


FD 8Edd 




ADC 


A,(IY+dd) 


39 


* 


ADD 


HL,SP 


8F 




ADC 


A,A 


DD 09 




ADD 


IX,BC 


88 


* 


ADC 


A,B 


DD 19 




ADD 


IX,DE 


89 


* 


ADC 


A,C 


DD 29 




ADD 


IX,IX 


8A 


* 


ADC 


A,D 


DD 39 




ADD 


IX,SP 


SB 


* 


ADC 


A,E 


FD 09 




ADD 


IY,BC 


8C 




ADC 


A,H 


FD 19 




ADD 


lY.DE 


8D 


* 


ADC 


A,L 


FD 29 




ADD 


IY,IY 


CE nn 


* 


ADC 


A, nn 


FD 39 




ADD 


IY,SP 


ED 4A 




ADC 


HL,BC 


A6 


* 


AND 


(HL) 


ED 5A 




ADC 


HL,DE 


DD A6dd 




AND 


(IX+dd) 


ED 6A 




ADC 


HL,HL 


FD A6dd 




AND 


(lY+dd) 


ED 7A 




ADC 


HL,SP 


A7 ■ 


* 


AND 


A 


86 




ADD 


A,(HL) 


AO 


* 


AND 


B 


DD 86dd 




ADD 


A,(IX+dd) 


Al 


* 


AND 


C 


FD 86dd 




ADD 


A,(IY+dd) 


A2 


* 


AND 


D 


87 


* 


ADD 


A,A 


A3 


* 


AND 


E 


80 


* 


ADD 


A,B 


A4 


* 


AND 


H 


81 


* 


ADD 


A,C 


A5 


* 


AND 


L 


82 ' 


* 


ADD 


A,D 


E6 nn 


■ * 


AND 


nn 


83 


* 


ADD 


A,E 


CB 46 




BIT 


0,(HL) 


84 


* 


ADD 


A,H 


DD CBdd46 




BIT 


0,(IX+dd) 


85 


* 


ADD 


A,L 


FD CBdd46 




BIT 


0,(IY+dd) 


C6 nn 




ADD 


A, nn 


CB 47 




BIT 


0,A 


09 


* 


ADD 


HL,BC 


CB 40 




BIT 


0,B 
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CB 41 


BIT 


0,C 


CB 42 


BIT 


0,D 


CB 43 


BIT 


0,E 


CB 44 


BIT 


0,H 


inn ,* cr 

CB 45 


BIT 


0,L 


CB 4E 


BIT 


1,(HL) 


DD CBdd4E 


BIT 


l,(IX+dd) 


rD Or5aa4ji 


T>Tm 

BIT 


l,(IY+dd) 


CJti 4r 


BIT 


1,A 


CB 4o 


BIT 


1,B 


CB 49 


BIT 


1,C 


CB 4A 


BIT 


1,D 


CB 4B 


BIT 


1,E 


CB 4C 


BIT 


1,H 


CB 4D 


BIT 


1,L 


CB 56 


BIT 


2,(HL) 


DD CBddSe 


BIT 


2,(IX+dd) 


FD CBdd56 


BIT 


2,(IY+dd) 


CB 57 


BIT 


2,A 


CB 50 


BIT 


2,B 


CB 51 


BIT 


2,C 


CB 52 


BIT 


2,D 


CB 53 


BIT 


2,E 


CB 54 


BIT 


2,H 


CB 55 


BIT 


2,L 


CB 5E 


BIT 


3,(HL) 


DD CBdd5E 


BIT 


3,(IX+dd) 


rU CBddoIii 


BIT 


3,(IY+dd) 


L/C or 


BIT 


3, A 


Crs 00 


T>Tm 

BIT 


3,B 


CB 59 


BIT 


3,C 


CB 5A 


BIT 


3,D 


CB 5B 


BIT 


3,E 


CB 5C 


BIT 


3,H 


CB 5D 


BIT 


3,L 


CB 66 


BIT 


4,{HL) 


DD CBdd66 


BIT 


4,(IX+dd) 


HU CiSdQDO 


BIT 


4,(IY+dd) 


CB 67 


BIT 


4, A 


OB 60 


BIT 


4,B 


Cr> 61 


BIT 


4,C 


CB 62 


BIT 


4,D 


CB 63 


BIT 


4,E 


CB 64 


BIT 


4,H 


CB 65 


BIT 


4,L 


CB 6E 


BIT 


5,(HL) 


DD CBdd6E 


BIT 


5,(IX+dd) 


FD CBdd6E 


BIT 


5,(IY+dd) 


CB 6F 


BIT 


5,A 



riex 




Mnemonic 


CB 68 




BIT 


5,B 


CB 69 




BIT 


5 C 


CB 6A 




BIT 


5 n 


CB 6B 




BIT 


5,E 


CB 6C 




BIT 


5,H 


CB 6D 




BIT 


5,L 


CB 76 




BIT 




DD CBdd76 




BIT 


6 ("TX+ddl 


FD CBdd76 




BIT 


6 flY+ddl 


CB 77 




BIT 


6,A 


CB 70 




BIT 


6,B 


CB 71 




RTT 


A P 


CB 72 




xSll 


D,1J 


CB 73 




Oil 


o,i!j 


CB 74 




£>! 1 


D,ii 


CB 75 




Joll 


C T 

b,Ii 


CB 7E 




xsll 


7,(HL) 


DD CBdd7E 




rsll 


/,(lA-f-aa) 


FD CBdd7E 




ml 




CB 7F 




mi 


7, A 


CB 78 




tSll 


7,B 


CB 79 




mi 


7 r* 
'>C 


CB 7A 




RTT 


7 n 


CB 7B 




RTT 
i>ii 


7 V 


CB 7C 




RTT 


7 H 


CB 7D 




RTT 

XII J. 


7 T, 


DC nnnn 


* 


r AT.T. 


£ n n VI 

V/, nnnn 


FC nnnn 


* 


nAT.T, 


Tin mn 

iVlj lllillll 


D4 nnnn 


* 


CALL 


TVirj nnnn 

■1- 1 u J llllJllXi 


CD nnnn 


* 


CALL 


nnnn 


C4 nnnn 


* 


CALL 


N7j nnnn 


F4 nnnn 


* 




X , llllilXX 


EC nnnn 


* 


CALL 


nnnn 

X XJj 111J,XJ,IL 


E4 nnnn 


* 


CALL 


PO nnnn 

X^ W , lllillll 


CC nnnn 


* 


CAT.T, 


7. nnnn 
/jj iliiiill 


3F 


* 






BE 


* 


CP 




DD BEdd 




pp 




FD BEdd 




PP 




BF 


* 


PP 


A 


B8 


* 


PP 


T> 


B9 


* 


CP 


c 


BA 


* 


CP 


D 


BB 




CP 


E 


BC 


* 


CP 


H 


BD 


* 


CP 


L 


FE nn 


* 


CP 


nn 


ED A9 




CPD 




ED B9 




CPDR 
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Mnemonic 


Hex 




Mnemonic 


ED Al 




CPI 




13 


* 


INC 


DE 






CPIR 




IC 


* 


INC 


E 


2F 


* 


CPL 




24 


* 


INC 


H 


97 


* 


DAA 




23 


* 


INC 


TTT 

HL 


35 


* 




(HL) 


DD 23 






TV 


DD 35dd 






(lA+aa) 


FD 23 




liNO 


T\7 


FD 35dd 






/TV J_#1#3\ 

(Ix+aa) 


2C 


* 


TNT/^ 
llNU 


T 

L 


3D 


* 


UbU 


A 

A 


33 


* 


llNO 


CD 

or 


05 


* 


TM?/"' 




ED AA 




liNiJ 




OB 


* 




BO 


ED BA 








OD 


* 






ED A2 




TMT 




15 


* 




U 


ED B2 




UN lit 




IB 


* 




_ 

jJsj 


E9 


* 


TP 


(HL) 


ID 


* 




F 


DD E9 




TP 




25 






TT 
XI 


FD E9 




TP 

dx 




2B 


* 




TTT 


DA nnnn 


* 


TP 

dx 


L>j nnnn 


DD 2B 




\Jsa\j 


lA 


FA nnnn 


* 


TP 

dx 


ivi, nnnn 


FD 2B 






TV 


D2 nnnn 


* 


TP 
dx 


iNOj nnnn 


2D 


* 




T 


C3 nnnn 


* 


TP 
dx 


nnnn 


3B 


* 


\Jsh\j 


Ox 


C2 nnnn 


* 


TP 
di 


"M^ TIM VI VI 

inzj, nnnn 


F3 


* 


HT 
Ui 




F2 nnnn 


* 


TP 

dx 


X , nnnn 


10 dd 






tlu 


EA nnnn 


* 


TP 

di 


PF MVIVIVI 

xI!j, nnnn 


FB 


* 


FT 




E2 nnnn 


* 


TP 

dx 


xu, nnnn 


E3 


* 


UfA 




CA nnnn 


* 


TP 

dx 


2, nnnn 


DD E3 




FV ■ 


/Cp\ TV 

(or j,iA 


38 dd 




TR 


o, aa 


FD E3 




£jA. 


TV 


18 dd 




TR 

dxL 


AA 

UU 


08 




FV 


A F A F ' 


30 dd 




TT? 
dit 


MP A A 


EB 


* 


FY 


^ TT|- 


20 dd 




TT> 
dK 


XT'/ A A 

INZi, uCt 


D9 




EjAA 




28 dd 




Tt? 


i6, UU 


76 


* 


rlALI 




02 


* 




(BC),A 


ED 46 




iiVl 


U 


12 


* 


T T^ 


(UL),A 


ED 56 




TTV/r 

IM 


1 


77 


* 


T T\ 


/TTT \ A 
\U\j) ,A 


ED 5E 




ilVl 




70 


* 


T T\ 
UU 


/TTT \ T> 

(HL),B 


ED 78 




TM 
li\ 


A 


71 


* 


VjXj 




DB nn 


* 


TTvT 


A,(nn) 


72 


* 


T T> 


/TTT \ 


ED 40 




TNT 


B,(C) 


73 


* 


T T\ 


/TTT \ 17< 


ED 48 




TNT 




74 


* 




/TTT \ TT 


ED 50 




UN 




75 


* 


T T\ 


/"TTT \ T 


ED 58 




TNT 




36 nn 


* 


T T\ 


(■t4T \ vivi 


ED 60 




liN 


"AW 


DD 77dd 




T T\ 


(^IAt^UUJ jA 


ED 68 




TN 


T, cr^ 


DD 70dd 




T,n 




34 




INC 


(HL) 


DD 71dd 




LD 


(IX+dd) ,C 


DD 34dd 




INC 


(IX+dd) 


DD 72dd 




LD 


(IX+dd) ,D 


FD 34dd 




INC 


(lY+dd) 


DD 73dd 




LD 


(IX+dd),E 


3C 


* 


INC 


A 


DD 74dd 




LD 


(IX+dd) ,H 


04 


* 


INC 


B 


DD 75dd 




LD 


(IX+dd) ,L 


03 


* 


INC 


BC 


DD 36ddnn 




LD 


(IX+dd), nn 


OC 


* 


INC 


C 


FD 77dd 




LD 


(IY+dd),A 


14 


* 


INC 


D 


FD 70dd 




LD 


(IY+dd),B 
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IVXIlcIIILlIllL 


FD 71dd 




LD 


(IY+dd),C 


FD 72dd 




LD 


(IY+dd),D 


FD 73dd 




LD 


(IY+dd),E 


FD 74dd 




LD 


(IY+dd),H 


FD 75dd 




LD 


(IY+dd),L 


FD 36ddnn 




LD 


(lY+dd), nn 


32 nnnn 


* 


LD 


(nnnn), A 


ED 43nnnn 




LD 


(nnnn),BC 


ED 53nnnn 




LD 


(nnnn),DE 


22 nnnn 


* 


LD 


(nnnn),HL 


DD 22nnnn 




LD 


(nnnn),IX 


FD 22nnnn 




LD 


(nnnn),IY 


ED 73nnnn 




LD 


(nnnn),SP 


OA 


* 


LD 


A,(BC) 


lA 


* 


LD 


A,(DE) 


7E 


* 


LD 


A,(HL) 


DD 7Edd 




LD 


A,(IX+dd) 


FD 7Bdd 




LD 


A,(IY+dd) 


3A nnnn 


* 


LD 


A, (nnnn) 


7F 


* 


LD 


A,A 


78 


* 


LD 


A,B 


79 


* 


LD 


A,C 


7A 


* 


LD 


A,D 


7B 


* 


LD 


A,E 


7C 


* 


LD 


A,H 


ED 57 




LD 


A,I 


7D 


* 


LD 


A,L 


3E nn 


* 


LD 


A, nn 


ED 5F 




LD 


A,R 


46 


* 


LD 


B,(HL) 


DD 46dd 




LD 


B,(IX+dd) 


FD 46dd 




LD 


B,(IY+dd) 


47 


* 


LD 


B,A 


40 




LD 


B,B 


41 


* 


LD 


B,C 


42 


* 


LD 


B,D 


43 


* 


LD 


B,E 


44 


* 


LD 


B,H 


45 


* 


LD 


B,L 


06 nn 


* 


LD 


B, nn 


ED 4Bnnnn 




LD 


BC, (nnnn) 


01 nnnn 




LD 


BC, nnnn 


4E 


* 


LD 


C,(HL) 


DD 4Edd 




LD 


C,(IX+dd) 


FD 4Edd 




LD 


C,(IY+dd) 


4F 




LD 


C,A 


48 


* 


LD 


C,B 


49 


* 


LD 


C,C 


4A 


* 


LD 


C,D 



tiex 






Mnemonic 


4B 


* 


LD 


C,E 


4C 


* 


LD 


C,H 


4D 


* 


LD 


C,L 


OE nn 


* 


LD 


C, nn 


56 


* 


LD 


D,(HL) 


DD 56dd 




LD 


D,(IX+dd) 


FD 56dd 




LD 


D,(IY+dd) 


57 


* 


LD 


D,A 


50 


* 


LD 


D,B 


51 


* 


LD 


D,C 


52 


* 


LD 


D,D 


53 


* 


LD 


D,E 


54 


* 


LD 


D,H 


55 


* 


LD 


D,L 


16 nn 


* 


LD 


D, nn 


ED 5Bnnnn 




LD 


DE, (nnnn) 


11 nnnn 


* 


LD 


DE, nnnn 


5E 


* 


LD 


E,(HL) 


DD 5Edd 




LD 


E,(IX+dd) 


FD 5Edd 




LD 


E,(IY+dd) 


5F 


* 


LD 


E,A 


58 


* 


LD 


E,B 


59 


* 


LD 


E,C 


5A 


* 


LD 


E,D 


5B 


* 


LD 


E,E 


5C 


* 


LD 


E,H 


5D 




LD 


E,L 


IE nn 


* 


LD 


E, nn 


66 


* 


LD 


H,(HL) 


DD 66dd 




LD 


H,(lX+dd) 


FD 66dd 




LD 


H,(IY+dd) 


67 


* 


LD 


H,A 


60 


* 


LD 


H,B 


61 


* 


LD 


H,C 


62 


* 


LD 


H,D 


63 


* 


LD 


H,E 


64 


* 


LD 


H,H 


65 


* 


LD 


H,L 


26 nn 


* 


LD 


H, nn 


2A nnnn 


* 


LD 


HL, (nnnn) 


21 nnnn 


* 


LD 


HL, nnnn 


ED 47 




LD 


I,A 


DD 2Annnn 




LD 


IX, (nnnn) 


DD 21nnnn 




LD 


IX, nnnn 


FD 2Annnn 




LD 


lY, (nnnn) 


FD 21nnnn 




LD 


lY, nnnn 


6E 


* 


LD 


L,(HL) 


DD 6Edd 




LD 


L,(IX+dd) 


FD 6Edd 




LD 


L,(IY+dd) 
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6F 


* 


LD 


L,A 


68 


* 


LD 


L,B 


69 


* 


LD 


L,C 


6A 


* 


LD 


L,D 


6B 


* 


LD 


L,E 


6C 


* 


LD 


L,H 


6D 




LD 


L,L 


2E nn 


* 


LD 


L, nn 


ED 4F 




LD 


R,A 


ED 7Bnnnn 




LD 


SP, (nnnn) 


F9 




LD 


SP,HL 


DD F9 




LD 


SP,IX 


FD F9 




LD 


SP,IY 


31 nnnn 


* 


LD 


SP, nnnn 


ED A8 




LDD 




ED B8 




LDDR 




ED AO 




LDI 




ED BO 




LDIR 




ED 44 




NEG 




00 


* 


NOP 




B6 




OR 


(HL) 


DD B6dd 




OR 


(IX+dd) 


FD B6dd 




OR 


(lY+dd) 


B7 


* 


OR 


A 


BO 


* 


OR 


B 


Bl 


* 


OR 


C 


B2 


* 


OR 


D 


B3 


* 


OR 


E 


B4 


* 


OR 


H 


B5 


* 


OR 


L 


F6 nn 


* 


OR 


nn 


ED BB 




OTDR 




ED B3 




OTIR 




ED 79 




OUT 


(C),A 


ED 41 




OUT 


(C),B 


ED 49 




OUT 


(C),C 


ED 51 




OUT 


(C),D 


ED 59 




OUT 


(C),E 


ED 61 




OUT 


(C),H 


ED 69 




OUT 


(C),L 


D3 nn 


* 


OUT 


(nn),A 


ED AB 




OUTD 




ED A3 




OUTI 




Fl 


* 


POP 


AF 


CI 


* 


POP 


BC 


Dl 


* 


POP 


DE 


El 


* 


POP 


HL 


DD El 




POP 


IX 


FD El 




POP 


lY 



Hex Mnemonic 



F5 


* PUSH 


AF 


C5 


* PUSH 


BC 


D5 


* PUSH 


DE 


E5 


* PUSH 


HL 


DD E5 


PUSH 


IX 


FD E5 


PUSH 


lY 


CB 86 


RES 


0,(HL) 


DD CBdd86 


RES 


0,(IX+d.d) 


FD CBdd86 


RES 


0,(IY+dd) 


CB 87 


RES 


0,A 


CB 80 


RES 


0,B 


CB 81 


RES 


0,C 


CB 82 


RES 


0,D 


CB 83 


RES 


0,E 


CB 84 


RES 


o[h 


CB 85 


RES 


0,L 


CB 8E 


RES 


1,(HL) 


DD CBdd8E 


RES 


1, (IX+dd) 


FD CBddSE 


RES 


l,(IY+dd) 


CB 8F 


RES 


1,A 


CB 88 


RES 


1,B 


CB 89 


RES 


1,C 


CB 8A 


RES 


1,D 


CB 8B 


RES 


1,E 


CB 8C 


RES 


1,H 


CB 8D 


RES 


1,L 


CB 96 


RES 


2,(HL) 


DD CBdd96 


RES 


2,(IX+dd) 


FD CBdd96 


RES 


2,(IY+dd) 


CB 97 


RES 


2,A 


CB 90 


RES 


2,B 


CB 91 


RES 


2,C 


CB 92 


RES 


2,D 


CB 93 


RES 


2,E 


CB 94 


RES 


2,H 


CB 95 


RES 


2,L 


CB 9E 


RES 


3,(HL) 


DD CBdd9E 


RES 


3,(IX+dd) 


FD CBdd9E 


RES 


3,(IY+dd) 


CB 9F 


RES 


3,A 


CB 98 


RES 


3,B 


CB 99 


RES 


3,C 


CB 9A 


RES 


3,D 


CB 9B 


RES 


3,E 


CB 9C 


RES 


3,H 


CB 9D 


RES 


3,L 


CB A6 


RES 


4,(HL) 


DD CBddA6 


RES 


4, (IX+dd) 


FD CBddA6 


RES 


4,(IY+dd) 
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CB A7 


RES 


4,A 


CB AO 


RES 


4,B 


CB Al 


RES 


4,C 


CB A2 


RES 


4,D 


CB A3 


RES 


4,E 


CB A4 


RES 


4,H 


CB A5 


RES 


4,L 


CB AE 


RES 


5,(HL) 


DD CBddAE 


RES 


5,(IX+dd) 


FD CBddAE 


RES 


5,(IY+dd) 


CB AF 


RES 


5, A 


CB A8 


RES 


5,B 


CB A9 


RES 


5,C 


CB AA 


RES 


5,D 


CB AB 


RES 


5,E 


CB AC 


RES 


5,H 


CB AD 


RES 


5,L 


CB B6 


RES 


6,(HL) 


DD CBddB6 


RES 


6,(IX+dd) 


FD CBddB6 


RES 


6,(IY+dd) 


CB B7 


RES 


6,A 


CB BO 


RES 


6,B 


CB Bl 


RES 


6,C 


CB B2 


RES 


6,D 


CB B3 


RES 


6,E 


CB B4 


RES 


6,H 


CB B5 


RES 


6,L 


CB BE 


RES 


V.(HL) 


DD CBddBE 


RES 


7,(IX+dd) 


FD CBddBE 


RES 


7,(lY+dd) 


CB BF 


RES 


7,A 


CB B8 


RES 


7,B 


CB B9 


RES 


7,C 


CB BA 


RES 


7,D 


CB BB 


RES 


7,E 


CB BC 


RES 


7.H 


CB BD 


RES 


7,L 


C9 


* RET 


D8 


* RET 


C 


F8 


* RET 


M 


DO 


* RET 


NC 


CO 


* RET 


NZ 


FO 


* RET 


P 


E8 


* RET 


PE 


EO 


* RET 


PO 


C8 


* RET 


Z 


ED 4D 


RETI 




ED 45 


RETN 




CB 16 


RL 


(HL) 



Hex Mnemonic 



DD OUaalD 




TIT 

RL 


(IX+dd) 


rD (JBdalb 




RL 


(lY+dd) 






PT 
till 


A 






PT 


■D 
Si 


PR 1 1 




RT 
fiij 


P 


PT3 1 




PT 


T\ 

U 


PP 1 Q 




PT 


Jii 


PP 1 A 




PT 


Jtl 


PR 1 K 




PT 


T 

Li 


1 7 




PT A 




PR nft 




PT P 


(Hi,) 






PT P 


(iA+aOj 






PT P 




PR 07 




PT P 


A 
A 


PR on 






J3 


PR 01 




RT P 


p 


PR 09 




PT P 


JJ 


PP HQ 








PP r\A 




K.LO 


TT 

xi 


L>D Uo 




RLC 


T 

L 


U7 




RLCA 




£jD br 




RLD 




CB IE 




RR 


(HL) 


DD CBddlE 




RR 


(IX+dd) 


FD CBddlE 




RR 


(lY+dd) 


\jD Ir 




Ti TJ 

RR 


A 


LiD lb 




KR 


TJ 

a 


l/C 19 




KK 


U 


CB lA 




RR 


D 


CB IB 




RR 


E 


UJtJ IC 




RR 


H 


L/IS ID 




RR 


L 


Ir 




RRA 




OtJ AT? 




T5 T> P 


(HL) 


UU ujtsaaUJci 




r> T> 


/TV 1 JJ\ 

(lA+dd) 


rU OBddUJi 




r> T> p 


(lYrdd) 


PR nir 
L/Jj Ur 






A 

A 






r> TJ p 


T) 


ots (jy 




r> r> p 




PR n A 
CrS UA 






T^ 
U 


PD nT> 






T7 


CB OC 




RRC 


H 


CB OD 




RRC 


L 


OF 


* 


RRCA 




ED 67 




RRD 




C7 


* 


RST 





CF 


* 


RST 


8 


D7 


* 


RST 


lOH 


DF 


* 


RST 


18H 
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E7 


* 


RST 


20H 


EF 




RST 


28H 


F7 


* 


RST 


30H 


FF 




RST. 


38H 


9E 


* 


SBC 


A,(HL) 


DD 9Edd 




SBC 


A,(IX+dd) 


FD 9Edd 




SBC 


A,(IY+dd) 


9F 


* 


SBC 


A,A 


98 


* 


SBC 


A,B 


99 


* 


SBC 


A,C 


9A 


* 


SBC 


A,D 


9B 


* 


SBC 


A,E 


9C 


* 


SBC 


A,H 


9D 


* 


SBC 


A,L 


DE nn 


* 


SBC 


A, nn 


ED 42 




SBC 


HL,BC 


ED 52 




SBC 


HL,DE 


ED 62 




SBC 


HL,HL 


ED 72 




SBC 


HL,SP 


37 


* 


SCF 




CB C6 




SET 


0,(HL) 


DD CBddCe 




SET 


0,(IX+dd) 


FD CBddCe 




SET 


0,(IY+dd) 


CB C7 




SET 


0,A 


CB CO 




SET 


0,B 


CB CI 




SET 


0,C 


CB C2 




SET 


0,D 


CB C3 




SET 


0,E 


CB C4 




SET 


0,H 


CB C5 




SET 


0,L 


CB CE 




SET 


1,(HL) 


DD CBddCE 




SET 


l,(IX+dd) 


FD CBddCE 




SET 


l,(IY+dd) 


CB CF 




SET 


1,A 


CB C8 




SET 


1,B 


CB C9 




SET 


1,C 


CB CA 




SET 


1,D 


CB CB 




SET 


1,E 


CB CC 




SET 


1,H 


CB CD 




SET 


1,L 


CB D6 




SET 


2,(HL) 


DD CBddD6 




SET 


2,(IX+dd) 


FD CBddD6 




SET 


2,(IY+dd) 


CB D7 




SET 


2, A 


CB DO 




SET 


2,B 


CB Dl 




SET 


2,C 


CB D2 




SET 


2,D 


CB D3 




SET 


2,E 


CB D4 




SET 


2,H 





Hex 


Mnemonic 


OB 


Uo 


SET 


2,L 


r^T3 
Ud 


UEj 


SET 


3,(HL) 


uu 


OBddUlii 


SET 


3,(IX+dd) 


rU 


OBddUE 


SET 


3,(IY+dd) 


nti 


Tit? 
Ur 


SET 


3,A 


Vd 


Uo 


SET 


3,B 


L/J5 


uy 


SET 


3,C 


CB 


DA 


SET 


3,D 


CB 


DB 


SET 


3,E 


CB 


DC 


SET 


3,H 


CB 


DD 


SET 


3,L 


CB 


E6 


SET 


4,(HL) 


DD 


CBddE6 


SET 


4,(IX+dd) 


FD 


CBddE6 


SET 


4,(IY+dd) 


CB 


E7 


SET 


4, A 


CB 


EO 


SET 


4,B 


CB 


El 


SET 


4,C 


CB 


E2 


SET 


4,D 


CB 


E3 


SET 


4,E 


CB 


TTi A 


SET 


4,H 


CB 




SET 


4,L 


OB 




SET 


5,(HL) 


Uu 




SET 


5,(IX+dd) 


rU 




SET 


5,(IY+dd) 


OrS 


EjF 


SET 


5,A 


OlJ 


HiO 


SET 


5,B 


013 




SET 


5,C 


Ori 


T? A 


SET 


5,D 


Od 


riJtS 


SET 


5,E 


OrS 




SET 


5,H 


PU 

Od 




SET 


5,L 


pn 
Oli 


r b 


SET 


6,(HL) 


UU 


CBaar o 


SET 


6,(1X4 dd) 


rU 


Onaaro 


SET 


6,(IY+dd) 


PT> 

Od 


T7"7 


SET 


6,A 


PT5 

OB 


rU 


SET 


6,B 


PT3 

OB 


r 1 


SET 


6,C 


CB 


F2 


SET 


6,D 


CB 


F3 


SET 


6,E 


CB 


F4 


SET 


6,H 


CB 


F5 


SET 


6,L 


OB 


ch 


SET 


7,(HL) 


DD 


CBddFE 


SET 


7,(IX+dd) 


FD 


CBddFE 


SET 


7,(IY+dd) 


CB 


FF 


SET 


7,A 


CB 


F8 


SET 


7,B 


CB 


F9 


SET 


7,C 


CB 


FA 


SET 


7,D 


CB 


FB 


SET 


V,E 
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OX!il 


7 H 


CB FD 


0£L| X 


7 T 


CB 26 






DD CBdri2fi 


ST, A 




FD CBdd26 


SLA 


flY+ddl 

^ J. J. 1 Vi KX j 


CB 27 


SLA 


A 


CB 20 


SLA 


B 


CB 21 


SLA 




CB 22 


SLA 


D 


CB 23 


SLA 


E 


CB 24 


SLA 


H 


CB 25 


SLA 


L 


CB 2E 


SRA 




DD CBdd2E 


SRA 


ClX+ddl 


FD CBdd2E 


SRA 


(lY+dd) 


CB 2F 


SRA 


A 


CB 28 


SRA 


B 


CB 29 


SR A 


n 

v. 


r, R 9 A 


A 


r> 
J-/ 


CB 2B 


SRA 


E 


CB 2C 


SRA 


H 


CB 2D 


SRA 


L 


CB 3E 


SRL 


(HL) 


DD CBddSE 


SRL 


(IX+dd) 


FD CBddSE 


SRL 


(lY+dd) 


CB 3F 


SRL 


A 


CB 38 


SRL 


B 



Hex Mnemonic 









r\ 
\j 








U 


PR ^tR 






T? 
Cj 


PR ^P 




CP T 




PR 




GPT 


T 

U 














GTTR 


^iATacij 






CJTTR 




97 


* 


SITR 

O VJX> 


A 


90 


* 


STIR 


R 
x> 


91 


* 


SUB 


p 




* 


outs 


V) 




* 


QTTR 


TT 




* 




xl 




* 


GTTR 


T 


D6 nn 


* 




nn 




* 


AUiX 








AUlt 


(lA+adj 


r u AJiaa 




AUK 


(lY+dd) 


AF 


* 


XOR 


A 


A8 


* 


XOR 


B 


A9 


* 


XOR 


C 


AA 


* 


XOR 


D 


AB 


* 


XOR 


E 


AC 


* 


XOR 


H 


AD 


* 


XOR 


L 


EE nn 


* 


XOR 


nn 



APPENDIX F 

The Z-80 Instruction Set 
(Numeric) 



The Zilog Z-80 instruction set is listed numerically with the corresponding 
hexadecimal values. The following representations apply. 

nn 8-bit argument 

nnnn 16-bit argument 

dd 8-bit signed displacement 

* instructions common to the 8080 





Hex 




Mnemonic 




Hex 




Mnemonic 


00 




* 


NOP 




IC 




* 


INC 


E 


01 


nnnn 


* 


LD 


BC, nnnn 


ID 




* 


DEC 


E 


02 




* 


LD 


(BC),A 


IE 


nn 


* 


LD 


E, nn 


03 




* 


INC 


BC 


IF 




* 


RRA 




04 




* 


INC 


B 


20 


dd 




JR 


NZ, dd 


05 




* 


DEC 


B 


21 


nnnn 




LD 


HL, nnnn 


06 


nn 


* 


LD 


B, nn 


22 


nnnn 


* 


LD 


(nnnn),HL 


07 




* 


RLCA 




23 




* 


INC 


HL 


08 






EX 


AF,AF' 


24 




* 


INC 


H 


09 




* 


ADD 


HL,BC 


25 




* 


DEC 


H 


OA 






LD 


A,(BC) 


26 


nn 


* 


LD 


H, nn 


OB 




* 


DEC 


BC 


27 




* 


DAA 




OC 




* 


INC 


C 


28 


dd 




JR 


Z, dd 


OD 




* 


DEC 


C 


29 






ADD 


HL,HL 


OE 


nn 


* 


LD 


C, nn 


2A 


nnnn 


* 


LD 


HL, (nnnn) 


OF 






RRCA 




2B 




* 


DEC 


HL 


10 


dd 




DJNZ 


dd 


2C 




* 


INC 


L 


11 


nnnn 


* 


LD 


DE, nnnn 


2D 




* 


DEC 


L 


12 




* 


LD 


(DE),A 


2E 


nn 


* 


LD 


L, nn 


13 




* 


INC 


DE 


2F 




* 


CPL 




14 




* 


INC 


D 


30 


dd 




JR 


NC,dd 


15 




* 


DEC 


D 


31 


nnnn 


* 


LD 


SP, nnnn 


16 


nn 


* 


LD 


D, nn 


32 


nnnn 


* 


LD 


(nnnn), A 


17 




* 


RLA 




33 




* 


INC 


SP 


18 


dd 




JR 


dd 


34 




* 


INC 


(HL) 


19 




* 


ADD 


HL,DE 


35 




* 


DEC 


(HL) 


lA 




* 


LD 


A,(DE) 


36 


nn 


* 


LD 


(HL), nn 


IB 




* 


DEC 


DE 


37 




* 


SCF 





272 



APPENDIX F 273 



Hex Mnemonic 



38 


dd 




JR 


C, dd 


39 




* 


ADD 


HL,SP 


3A 


nnnn 


* 


LD 


A, (nnnn) 


3B 




* 


DEC 


SP 


3C 




* 


INC 


A 


3D 




* 


DEC 


A 


3E 


nn 


* 


LD 


A, nn 


3F 




* 


CCF 




40 




* 


LD 


B,B 


41 




* 


LD 


B,C 


42 




* 


LD 


R n 


43 




* 


LD 




44 






XJXJ 


R H 


45 




* 




R T 


46 




* 


LD 




47 




* 


LD 


R A 


48 




* 


LD 


C, R 


49 




* 


LD 




4A 




* 


LD 




4B 




* 


LD 


C,E 


4C 




* 


LD 


C,H 


4D 




* 


LD 


C.L 


4E 




* 


LD 


C'(HL) 


4F 




* 


LD 


C,A 


50 




* 


LD 


D,B 


51 




* 


LD 


D,C 


52 




* 


LD 


D,D 


53 






LD 


D,E 


54 




* 


LD 


D,H 


55 




* 


LD 


D,L 


56 




* 


LD 


D,(HL) 


57 




* 


LD 


D,A 


58 






LD 


E,B 


59 




* 


LD 


E,C 


5A 




* 


LD 


E,D 


5B 




* 


LD 


E,E 


5C 




* 


LD 


E,H 


5D 




* 


LD 


E,L 


5E 




* 


LD 


E,(HL) 


5F 




* 


LD 


F, A 


60 




* 


LD 


H,B 


61 




* 


LD 


H,C 


62 




* 


LD 


H,D 


63 




* 


LD 


H,E 


64 




* 


LD 


H,H 


65 




* 


LD 


H,L 


66 




* 


LD 


H,(HL) 


67 




* 


LD 


H,A 


68 




* 


LD 


L,B 



Hex Mnemonic 



69 


* 


LD 


L,C 


6A 


* 


LD 


L,D 


6B 




LD 


L,E 


6C 


* 


LD 


L,H 


6D 


* 


LD 


L,L 


6E 


* 


LD 




6F 


* 


LD 


L,A 


70 


* 


T r» 

LiU 




71 


* 


T n 




79 




i-tU 


/TTT \ Til 


1 o 




T ri 


(HL),E 


74 




T T\ 
LiU 


/TTT \ TT 

(HL),H 


1 D 




T 


(HL),L 


7fi 




HAT TP 




77 






/TTT \ A 

(HL),A 


78 




LD 


A,B 


70 




T 


A,0 


7 A 




T 


A Fl 
A,U 


7R 




T r\ 
LiU 


A,x!i 


7r 


* 


T F» 

LiiJ 




7D 




T n 


A T 


7E 


* 


LD 


a,^xiij; 


7F 


* 


T n 


A A 
A, A 




* 


A nn 


A R 


81 


* 


Ann 


A P 


82 


* 


Ann 


A n 


83 


* 


Ann 


A F 
A,JZi 


84 




Ann 


A H 


85 


* 


Ann 


A T 


86 


* 


ADD 




87 


* 


Ann 


A A 

AjA 


88 


* 




A R 


89 


* 




A P 


8A 


* 


A TIP 


A n 


8B 


* 


A HP 


A P 


8C 


* 


AFIP 


A H 
A,rl 


8n 

OJ-/ 


* 


AFlP 


A T 


BE 


* 


A DP 






* 




A A 
A,A 






GTTTi 


Jts 


91 


* 




P 


92 




SUB 


D 


93 


* 


SUB 


E 


94 


* 


SUB 


H 


95 


* 


SUB 


L 


96 


* 


SUB 


(HL) 


97 


* 


SUB 


A 


98 


* 


SBC 


A,B 


99 


* 


SBC 


A,C 
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Hex 




Mnemonic 




Hex 


Mnemonic 


n A 






SBC 


A,D 




UU 


RLC 


B 


yb 






SBC 


A,E 




UX 


RLC 


C 








SBC 


A,H 


L/lJ 


no 


RLC 


D 


yij 






SBC 


A,L 


nTi 
UlS 


HQ 


RLC 


E 


\jrj 






SBC 


A,(HL) 




H/l 
U4 


RLC 


H 


QT? 

yr 






SBC 


A,A 


PR 


hp; 
uo 


RLC 


L 


A n 




* 


AND 


B 




UD 


RLC 


(HL) 


A 1 
ill 




* 


AND 


C 




07 


RLC 


A 


A 






AND 


D 


PR 


uo 


RRC 


B 


A Q 




* 


AND 


E 


PR 


HQ 


RRC 


C 


A A 




* 


AND 


H 


PR 


HA 


RRC 


D 


A 






AND 


L 


PR 




RRC 


E 


Aft 






AND 


(HL) 


PR 


OP 


RRC 


H 


A7 






AND 


A 


PR 




RRC 


L 


Aft 






XOR 


B 


PR 

V.,- L' 




RRC 


(HL) 


AQ 




* 


XOR 


C 


PR 


OF 


RRC 


A 


A A 






XOR 


D 


PR 


1 n 


RL 


B 


AT4 




* 


XOR 


E 


PR 


1 1 


RL 


C 


AP 




* 


XOR 


H 


PR 


1 9 

x^ 


RL 


D 


An 




* 


XOR 


L 


PR 


1 


RL 


E 


AJii 






XOR 


(HL) 


PR 


X4 


RL 


H 


A IT 

Ar 






XOR 


A 


PR 


1 PI 

xo 


RL 


L 


OA 






OR 


B 


UrS 


1 a 
lo 


RL 


(HL) 


ni 
J3i 






OR 


C 


PR 


1 7 


RL 


A 


no 






OR 


D 




1 Q 
XO 


RR 


B 


Tt O 

Bo 






OR 


E 


OB 


ly 


RR 


C 


B4 






OR 


H 


OB 


-1 A 

lA 


RR 


D 


B5 






OR 


L 


OB 


IB 


RR 


E 


B6 






OR 


(HL) 


OB 




RR 


H 


■0*7 






OR 


A 


ots 


xU 


RR 


L 


bo 






CP 


B 


OJtS 


xrj 


RR 


(HL) 


rsy 






CP 


C 


OB 


xr 


RR 


A 


"D A 

rSA 






CP 


D 


PR 
OU 


on 


SLA 


B 


JtSJtS 






CP 


E 


PR 


01 


SLA 


C 








CP 


H 


PR 


LA 


SLA 


D 


i5U 






CP 


L 


PR 


9^ 


SLA 


E 


nv 




* 


CP 


(HL) 


PR 


9A 
Z4 


SLA 


H 


£jr 




t- 


CP 


A 


PR 


9^1 
zu 


SLA 


L 








RET 


NZ 


PR 


9fi 
zo 


SLA 


(HL) 


PI 




* 


POP 


BC 


PR 


97 
Z i 


SLA 


A 




nnnn 


* 


JP 


NZ, nnnn 


PR 


9ft 
Zo 


SRA 


B 


PQ 


nnnn 




JP 


nnnn 


PR 


OQ 

zy 


SRA 


C 


C4 


nnnn 


* 


CALL 


NZ, nnnn 


CB 


2A 


SRA 


D 


C5 




* 


PUSH 


BC 


CB 


2B 


SRA 


E 


C6 


nn 


* 


ADD 


A, nn 


CB 


2C 


SRA 


H 


C7 






RST 





CB 


2D 


SRA 


L 


C8 






RET 


Z 


CB 


2E 


SRA 


(HL) 


C9 




* 


RET 




CB 


2F 


SRA 


A 


CA 


nnnn 




JP 


Z, nnnn 


CB 


38 


SRL 


B 
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CB 


39 


SRL 


C 


CB 


3A 


SRL 


D 


CB 


3B 


SRL 


E 


CB 


3C 


SRL 


H 


CB 


3D 


SRL 


L 


CB 


3E 


SRL 


(HL) 


CB 


3F 


SRL 


A 


CB 


40 


BIT 


0,B 


CB 


41 


BIT 


0,C 


CB 


42 


BIT 


0,D 


CB 


43 


BIT 


0,E 


CB 


44 


BIT 


0,H 


CB 


45 


BIT 


OL 


CB 


46 


BIT 


0,(HL) 


CB 


47 


BIT 


0,A 


CB 


48 


BIT 


1,B 


CB 


49 


BIT 


i,c 


CB 


4A 


BIT 


1,D 


CB 


4B 


BIT 


1,E 


CB 


4C 


BIT 


1,H 


CB 


4D 


BIT 


1,L 


CB 


4E 


BIT 


1,(HL) 


CB 


4F 


BIT 


1,A 


CB 


50 


BIT 


2,B 


CB 


51 


BIT 


2,C 


CB 


52 


BIT 


2,D 


CB 


53 


BIT 


2,E 


CB 


54 


BIT 


2,H 


CB 


55 


BIT 


2,L 


CB 


56 


BIT 


2,(HL) 


CB 


57 


BIT 


2,A 


CB 


58 


BIT 


3,B 


CB 


59 


- BIT 


3,C 


CB 


5A 


BIT 


3,D 


CB 


5B 


BIT 


3,E 


CB 


5C 


BIT 


3,H 


CB 


5D 


BIT 


3,L 


CB 


5E 


BIT 


3,(HL) 


CB 


5F 


BIT 


3,A 


CB 


60 


BIT 


4,B 


CB 


61 


BIT 


4,C 


CB 


62 


BIT 


4,D 


CB 


63 


BIT 


4,E 


CB 


64 


BIT 


4,H 


CB 


65 


BIT 


4,L 


CB 


66 


BIT 


4,(HL) 


CB 


67 


BIT 


4, A 


CB 


68 


BIT 


5,B 


CB 


69 


BIT 


5,C 





Ilex 


Mnemonic 


CB 


6A 


RTT 




CB 


6B 


RTT 




CB 


6C 


RTT 


TT 


CB 


6D 


RTT 
ox I 


f^ T 


CB 


6E 


RTT 




CB 


6F 


RTT 




CB 


70 


■RTT 
oil 


0,0 


CB 


71 


RTT 
Dl 1 


a. n 


CB 


72 


oil 


c ir\ 
o,u 


CB 


73 


oil 


b,l!j 


CB 


74 


oil 


n u 
o,n 


CB 


75 


BIT 


6,L 


CB 


76 


IT I'll 

oil 


C /TIT ^ 

b,(HL} 


CB 


77 


BIT 


6, A 


CB 


78 


T)Tnn 

BIT 


7,B 


CB 


79 


BIT 


7,C 


CB 


7A 


Bil 


7,D 


CB 


7B 


Bil 


7,E 


CB 


7C 


Bil 


rr T T 

7,H 


CB 


7D 


Bil 


n T 

7,L 


CB 


7E 


£>1 1 


7 /'ITT \ 


CB 


7F 


oil 


1 A 


CB 


80 




U,rS 


CB 


81 


JVliO 


n n 
u,o 


CB 


82 




U,JJ 


CB 


83 


XvJCjD 




CB 


84 




n TT 


CB 


85 


JVIjO 


n T 


CB 


86 






CB 


87 






CB 


88 


RF<s 


1 R 
IjB 


CB 


89 


JtvJCiD 


1 C 


CB 


8A 


SXHiO 


1 T1 


CB 


8B 


xtJCiD 


1 IT 


CB 


8C 




1 TI 
1,11 


CB 


8D 






CB 


8E 






CB 


8F 




1 A 

1,A 


CB 


90 






CB 


91 




2,L 


CB 


92 






CB 


93 


RES 


2,E 


CB 


94 


RES 


2,H 


CB 


95 


RES 


2,L 


CB 


96 


RES 


2,(HL) 


CB 


97 


RES 


2,A 


CB 


98 


RES 


3,B 


CB 


99 


RES 


3,C 


CB 


9A 


RES 


3,D 
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CB 


9B 


RES 


3,E 


CB 


9C 


RES 


3,H 


CB 


9D 


RES 


3,L 


Ld 




Kiib 


3,(HL) 


CB 


yr 




O A 

o,A 


CB 


A A 
AO 




4,B 


Cxi 


A "1 

Al 


tltiO 


4,C 


LB 


A O 

A2 


KJiO 


4,D 


CB 


A O 
Ad 


Klib 


4, Ml 


OB 


A /f 

A4 


T>T?Q 
KJbib 


4,11 




AO 


Krib 


A T 

4,L 




Av 


Jet Jib 




CJtS 


A '7 


XV Jib 


A A 

4, A 


UJi 


A Q 
AO 


Ji^Jiib 


0,13 


CD 


A Q 

Ay 


KJib 


o,c 


CJ3 


A A 

AA 


KJib 


o,u 


CU 


A "D 

AO 


IV lib 


0,Ji 


CJ3 


A r< 
AC 


KJib 


K TJ 
0,Jul 


Co 


A n 
AU 


KJib 


K T 


Ci> 


A P 
AtL 


KJib 




CB 


A T? 

Ar 


Kiib 


C A 

o,A 


CB 


Tin 

BO 


Rxib 


D,B 


CB 


Bl 


RES 


6,C 


CB 


B2 


RES 


6,D 


CB 


B3 


RES 


6,E 


CB 


B4 


RES 


6,H 


CB 


B5 


RES 


6,L 


CB 


B6 


RES 


6,(HL) 


CB 


B7 


RES' 


6, A 


CB 


B8 


RES 


7,B 


CB 


B9 


RES 


7,C 


CB 


BA 


RES 


7,D 


/"IT* 


TiVi 

BB 


Rbb 


7,E 




B(J 


T-> XT' n 


7,H 


/IT) 


BlJ 




7,L 




i5j1i 




' ,("L) 


Cd 


T>X? 




7, A 




r^n 
UU 


OCjI 










u,o 






oJCii 


U,U 






OCj 1 




CB 


C4 


SET 


0,H 


CB 


C5 


SET 


0,L 


CB 


C6 


SET 


0,(HL) 


CB 


C7 


SET 


0,A 


CB 


C8 


SET 


1,B 


CB 


C9 


SET 


1,C 


CB 


CA 


SET 


1,D 


CB 


CB 


SET 


1,E 
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PR 


PP 


SET 


1,H 


PR 


pn 


SET 


1,L 


PR 


PR 


SET 


1,(HL) 


CB 


CF 


SET 


1,A 


CB 


DO 


SET 


2,B 


CB 


Dl 


SET 


2,C 


CB 


D2 


SET 


2,D 


CB 


D3 


SET 


2,E 


CB 


D4 


SET 


2,H 


CB 


D5 


SET 


2,L 


CB 


D6 


SET 


2,(HL) 


CB 


D7 


SET 


2,A 


CB 


D8 


SET 


3,B 


CB 


D9 


SET 


3,C 


CB 


DA 


SET 


3,D 


CB 


DB 


SET 


3,E 


CB 


DC 


SET 


3,H 


CB 


DD 


SET 


3,L 


CB 


DE 


SET 


3,(HL) 


CB 


DF 


SET 


3,A 


CB 


EO 


SET 


4,B 


CB 


El 


SET 


4,C 


v.- 1 > 




SET 


4,0 






SET 


4,E 






SET 


4,H 






SET 


4,L 


TR 




SET 


4,(HL) 


r,R 


R7 


SET 


4,A 


PR 
^O 




SET 


5,B 


PR 

l_yO 


pq 


SET 


5,C 


PR 


PA 


SET 


5,D 


J.) 


PR 


SET 


5,E 


PR 


PP 


SET 


5,H 


PR 
vo 




SET 


5,L 


CB 


EE 


SET 


5,(HL) 


CB 


EF 


SET 


5,A 


CB 


FO 


SET 


6,B 


CB 


Fl 


SET 


6,C 


CB 


F2 


SET 


6,D 


CB 


F3 


SET 


6,E 


CB 


F4 


bJii 


<o,rl 


CB 


F5 


SET 


6,L 


CB 


F6 


SET 


6,(HL) 


CB 


F7 


SET 


6,A 


CB 


F8 


SET 


7,B 


CB 


F9 


SET 


7,C 


CB 


FA 


SET 


V,D 


CB 


FB 


SET 


7,E 


CB 


FC 


SET 


7,H 
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CB FD 




SET 


7,L 


CB FE 




SET 


7,(HL) 


CB FF 




SET 


7, A 


CC nnnn 


* 


CALL 


Z, nnnn 


CD nnnn 


* 


CALL 


nnnn 


CE nn 


* 


ADC 


A, nn 


CF 


* 


RST 


8 


DO 


* 


RET 


NC 


Dl 


* 


POP 


DE 


D2 nnnn 




JP 


NC, nnnn 


D3 nn 


* 


OUT 


(nn),A 


D4 nnnn 


* 


CALL 


NC, nnnn 


D5 


* 


PUSH 


DE 


D6 nn 


* 


SUB 


nn 


D7 


* 


RST 


lOH 


D8 


* 


RET 


C 


D9 




EXX 




DA nnnn 


* 


JP 


C, nnnn 


DB nn 


* 


IN 


A, (nn) 


DC nnnn 


* 


CALL 


C, nnnn 


DD 09 




ADD 


IX,BC 


DD 19 




ADD 


IX^DE 


DD 21nnnn 




LD 


IX, nnnn 


DD 22nnnn 




LD 


(nnnn), IX 


DD 23 




INC 


IX 


DD 29 




ADD 


IX,IX 


DD 2Annnn 




LD 


IX, (nnnn) 


DD 2B 




DEC 


IX 


DD 34dd 




INC 


(IX+dd) 


DD 35dd 




DEC 


(IX+dd) 


DD 36ddnn 




LD 


(IX+dd), nn 


DD 39 




ADD 


IX,SP 


DD 46dd 




LD 


B,(IX+dd) 


DD 4Edd 




LD 


C,(IX+dd) 


DD 56dd 




LD 


D,(IX+dd) 


DD 5Edd 




LD 


E,(IX+dd) 


DD 66dd 




LD 


H,(IX+dd) 


DD 6Edd 




LD 


L,(IX+dd) 


DD 70dd 




LD 


(IX+dd) ,B 


DD 71dd 




LD 


(IX+dd) ,C 


DD 72dd 




LD 


(IX+dd) ,D 


DD 73dd 




LD 


(IX+dd) ,E 


DD 74dd 




LD 


(IX+dd) ,H 


DD 75dd 




LD 


(IX+dd) ,L 


DD 77dd 




LD 


(IX+dd), A 


DD 7Edd 




LD 


A,(IX+dd) 


DD 86dd 




ADD 


A,(IX+dd) 


DD 8Edd 




ADC 


A,(IX+dd) 


DD 96dd 




SUB 


(IX+dd) 
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DD 


9Edd 


SBC 


A,(IX+dd) 


DD 


A6dd 


AND 


(IX+dd) 


DD 


AEdd 


XOR 


(IX+dd) 


DD 


B6dd 


OR 


(IX+dd) 


DD 


BEdd 


CP 


(IX+dd) 


DD 


CBddOe 


RLC 


(IX+dd) 


DD 


CBddOE 


RRC 


(IX+dd) 


DD 


CBddie 


RL 


(IX+dd) 


DD 


CBddlE 


RR 


(IX+dd) 


DD 


CBdd26 


SLA 


(IX+dd) 


DD 


CBdd2E 


SRA 


(IX+dd) 


DD 


CBdd3E 


SRL 


(IX+dd) 


DD 


CBdd46 


BIT 


0,(IX+dd) 


DD 


CBdd4E 


BIT 


1, (IX+dd) 


DD 


CBdd56 


BIT 


2,(IX+dd) 


DD 


CBdd5E 


BIT 


3,(IX+dd) 


DD 


CBdd66 


BIT 


4,(IX+dd) 


DD 


CBdd6E 


BIT 


5,(IX+dd) 


DD 


CBdd76 


BIT 


6,(IX+dd) 


DD 


CBdd7E 


BIT 


7,(IX+dd) 


DD 


CBdd86 


RES 


0,(IX+dd) 


DD 


CBdd8E 


RES 


1, (IX+dd) 


DD 


CBdd96 


RES 


2,(IX+dd) 


DD 


CBdd9E 


RES 


3,(IX+dd) 


DD 


CBddA6 


RES 


4,(IX+dd) 


DD 


CBddAE 


RES 


5,(IX+dd) 


DD 


CBddB6 


RES 


6,(IX+dd) 


DD 


CBddBE 


RES 


7, (IX+dd) 


DD 


CBddCe 


SET 


0,(IX+dd) 


DD 


CBddCE 


SET 


1, (IX+dd) 


DD 


CBddD6 


SET 


2,(IX+dd) 


DD 


CBddDE 


SET 


3,(IX+dd) 


DD 


CBddE6 


SET 


4,(IX+dd) 


DD 


CBddEE 


SET 


5,(IX+dd) 


DD 


CBddF6 


SET 


6,(IX+dd) 


DD 


CBddFE 


SET 


7, (IX+dd) 


DD 


El 


POP 


IX 


DD 


E3 


EX 


(SP),IX 


DD 


E5 


PUSH 


IX 


DD 


E9 


JP 


(IX) 


DD 


F9 


LD 


SPjIX 


DE 


nn 


* SBC 


A, nn 


DF 




* RST 


18H 


EO 




* RET 


PO 


El 




* POP 


HL 


E2 


nnnn 


* JP 


PO, nnnn 


E3 




* EX 


(SP),HL 


E4 


nnnn 


* CALL 


PO, nnnn 


E5 




* PUSH 


HL 
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Hex 


Mnemonic 




Hoy 




Mnemonic 


E6 


nn 


* AND 


nn 


ED 


A2 




INI 




E7 




* RST 


20H 


ED 


A3 




OTTTT 




E8 




* RET 


PE 


ED 


A8 




T,nn 

J-iULJ 




E9 




* JP 




ED 


A9 








EA 


nnnn 


* JP 


PE, nnnn 


ED 


AA 




IND 




EB 




* EX 


DE,HL 


ED 


AB 




DTTTn 




EC 


nnnn 


* CALL 


PE, nnnn 


ED 


BO 




T.DTR 




ED 


40 


IN 


B (C) 


ED 


Bl 




CPTR 




ED 


41 


OUT 


(C) B 


ED 


B2 




TNTR 




ED 


42 


SBC 


HL BC 


ED 


B3 




\} 1 lit. 




ED 


43nnnn 


LD 


Cnnnni RC 


ED 


B8 








ED 


44 






ED 


B9 




UrJJlv 




ED 


45 


RRTN 

XVJLJ X IN 




ED 


BA 




TTvITiT? 




ED 


46 


TM 


u 


ED 


BB 




r\rpT\T> 

UlUK 




ED 


47 


T n 


T 4 


EE 


nn 


* 


AUK 


IN 


ED 


48 


TNT 
UN 




EF 






Kt>l 


28H 


ED 


49 


riTTT 




FO 




* 


)XVa 1 


F 


ED 


4A 


A DP 




Fl 




* 


rUr 


Ax 


ED 


4Bnnnn 


T n 




F2 


nnnn 


* 


Jr 


P, nnnn 


ED 


4D 






F3 




* 


TTiT 

Ul 


ED 


4F 


LD 


R A 


F4 


nnnn 


* 


A T T 


P, nnnn 


ED 


50 


IN 




F5 




* 


ruDrl 




ED 


51 


OUT 


CO n 


F6 


nn 


* 




nn 


ED 


52 


SBC 


HL,DE 


F7 




* 


Jtvo 1 


OUiT 


ED 


53nnnn 


LD 




F8 




* 


XvlJ I 


IVi 


ED 


56 


IM 


1 


F9 




* 


T n 

XjL' 


Qp TJT 

or jXIJLj 


ED 


57 


LD 


A I 


FA 


nnnn 


* 


TP 


Tx/T M v» « 

jvij nunn 


ED 


58 


IN 


E (C) 


FB 




* 


FIT 

521%. 


ED 


59 


OUT 


(C) E 


FC 


nnnn 


* 




ivi, nnnn 


ED 


5A 


ADC 


HL,DE 


FD 


09 




ADD 


IY,BC 


ED 


5Bnnnn 


LD 


DE, (nnnn) 


FD 


19 




ADD 


IY,DE 


ED 


5E 


IM 


2 


FD 


21nnnn 




LD 


Ty nnnTi 

4. J. J illliiil 


ED 


5F 


LD 


A,R 


FD 


22nnnn 








ED 


60 


IN 


H,(C) 


FD 


23 




INC 


lY 


ED 


61 


OUT 


(C),H 


FD 


29 




ADD 


lYJY 


ED 


62 


SBC 


HL,HL 


FD 


2Annnn 




LD 


TY /'nnnn^ 


ED 


67 


RRD 




FD 


2B 




DEC 


lY 


ED 


68 


IN 


L (C) 


FD 


34dd 




INC 




ED 


69 


OUT 


(C) L 


FD 


35dd 




DEC 




ED 


6A 


ADC 


HL,HL 


FD 


36ddnn 




LD 


^X X 1 UU J , lili 


ED 


6F 


RLD 




FD 


39 




ADD 


IY,SP 


ED 


72 


SBC 


HL,SP 


FD 


46dd 




LD 


B,(IY+dd) 


ED 


73nnnn 


LD 


(nnnn),SP 


FD 


4Edd 




LD 


C,(IY+dd) 


ED 


78 


IN 


A,(C) 


FD 


56dd 




LD 


D,(IY+dd) 


ED 


79 


OUT 


(C),A 


FD 


5Edd 




LD 


E,(IY+dd) 


ED 


7A 


ADC 


HL,SP 


FD 


66dd 




LD 


H,(IY+dd) 


ED 


7Bnnnn 


LD 


SP, (nnnn) 


FD 


6Edd 




LD 


L,(IY+dd) 


ED 


AO 


LDI 




FD 


70dd 




LD 


(IY+dd),B 


ED 


Al 


CPI 




FD 


71dd 




LD 


(IY+dd),C 
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FD 


72dd 


LD 


(IY+dd),D 


FD 


73dd 


LD 


(IY+dd),E 


FD 


74dd 


LD 


(IY+dd),H 


FD 


75dd 


LD 


(IY4-dd),L 


FD 


77dd 


LD 


(IYfdd),A 


FD 


7Edd 


LD 


A,(IY+dd) 


FD 


86dd 


ADD 


A,(IY+dd) 


FD 


8Edd 


ADC 


A,(IY+dd) 


FD 


96dd 


SUB 


(lY+dd) 


FD 


9Edd 


SBC 


A,(IY+dd) 


FD 


A6dd 


AND 


(lY+dd) 


FD 


AEdd 


XOR 


(lY+dd) 


FD 


B6dd 


OR 


(lY+dd) 


FD 


BEdd 


CP 


(lY+dd) 


FD 


CBddOe 


RLC 


(lY+dd) 


FD 


CBddOE 


RRC 


(lY+dd) 


FD 


CBddie 


RL 


(lY+dd) 


FD 


CBddlE 


RR 


(lY+dd) 


FD 


CBdd26 


SLA 


(lY+dd) 


FD 


CBdd2E 


SRA 


(lY+dd) 


FD 


CBddSE 


SRL 


(lY+dd) 


FD 


CBdd46 


BIT 


0,(IY+dd) 


FD 


CBdd4E 


BIT 


l,(IY+dd) 


FD 


CBdd56 


BIT 


2,(IY+dd) 


FD 


CBddSE 


BIT 


3,(IY+dd) 


FD 


CBdd66 


BIT 


4,(IY+dd) 
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FD 


CBdd6E 


BIT 


5,(IY+dd) 


FD 


CBdd76 


BIT 


6,(IY+dd) 


FD 


CBdd7E 


BIT 


7,(IY+dd) 


FD 


CBdd86 


RES 


0,(IY+dd) 


FD 


CBddSE 


RES 


l,(IY+dd) 


FD 


CBdd96 


RES 


2,(IY+dd) 


FD 


CBdd9E 


RES 


3,(IY+dd) 


FD 


CBddA6 


RES 


4,(IY+dd) 


FD 


CBddAE 


RES 


5,(IY+dd) 


FD 


CBddB6 


RES 


6,(IY+dd) 


FD 


CBddBE 


RES 


7,(IY+dd) 


FD 


CBddCe 


SET 


0,(IY+dd) 


FD 


CBddCE 


SET 


l,(IY+dd) 


FD 


CBddD6 


SET 


2,(IY4-dd) 


FD 


CBddDE 


SET 


3,(IY4-dd) 


FD 


CBddES 


SET 


4,(IY+dd) 


FD 


CBddEE 


SET 


5,(IY+dd) 


FD 


CBddF6 


SET 


6,(IY+dd) 


FD 


CBddFE 


SET 


7,(IY+dd) 


FD 


El 


POP 


lY 


FD 


E3 


EX 


(SP),IY 


FD 


E5 


PUSH 


lY 


FD 


E9 


JP 


(lY) 


FD 


F9 


LD 


SP,IY 


FE 


nn 


* CP 


nn 


FF 




* RST 


38H 



APPENDIX G 

Cross-Reference of 
8080 and Z-80 Instructions 



The instructions are listed in alphabetic order according to the 8080 
mnemonic. The following representations are used. 

N 8-bit constant 

NN 16-bit constant 

R single register 

RR double register 

— range of values expressed as one character 
range of values expressed as two characters 



8080 


HEX 




Z-80 


code 


code 




code 


ACI 


N 


CE 


ADC 


A,N 


ADC 


M 


8E 


ADC 


A,(HL) 


ADC 


R 


8- 


ADC 


A,R 


ADD 


M 


86 


ADD 


A,(HL) 


ADD 


R 


8- 


ADD 


A,R 


ADI 


N 


C6 


ADD 


A,N 


ANA 


M 


A6 


AND 


(HL) 


ANA 


R 


A- 


AND 


R 


ANI 


N 


E6 


AND 


N 


CALL 


NN 


CD 


CALL 


NN 


CC 


NN 


DC 


CALL 


C,NN 


CM 


NN 


FC 


CALL 


M,NN 


CMA 




2F 


CPL 




CMC 




3F 


CCF 




CMP 


M 


BE 


CP 


(HL) 


CMP 


R 


B- 


CP 


R 


CNC 


NN 


D4 


CALL 


NC,NN 


CNZ 


NN 


C4 


CALL 


NZ,NN 


CP 


NN 


F4 


CALL 


P,NN 


CPE 


NN 


EC 


CALL 


PE,NN 


CPI 


N 


FE 


CP 


N 


CPO 


NN 


E4 


CALL 


PO,NN 


CZ 


NN 


CC 


CALL 


Z,NN 
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8080 


HEX 




Z-80 


code 


code 




code 


DAA 




27 


DAA 




DAD 


B 


09 


ADD 


HL,BC 


DAD 


D 


19 


ADD 


HL,DE 


DAD 


H 


29 


ADD 


HL,HL 


DAD 


SP 


39 


ADD 


HL,SP 


DCR 


M 


35 


DEC 


(HL) 


DCR 


R 





DEC 


R 


DCX 


B 


OB 


DEC 


BC 


DCX 


D 


IB 


DEC 


DE 


DCX 


H 


2B 


DEC 


HL 


DCX 


SP 


SB 


DEC 


SP 


DI 




F3 


DI 




EI 




FB 


EI 




HLT 




76 


HALT 


IN 


N 


DB 


TN 


A CN1 


INR 


M 


34 


INC 




INR 


R 





INC 


R 


INX 


B 


03 




TIP 


INX 


D 


13 


JNC, 




INX 


H 


23 




HL 


INX 


SP 


33 


UNO 


QP 

or 


JC 


NN 


DA 


TP 




JM 


NN 


FA 


TP 




JMP 


NN 


C3 


TP 


MM 


JNC 


NN 


D2 


JP 


NC,NN 


JNZ 


NN 


C2 


JP 


NZ^NN 


JP 


NN 


F2 


JP 


P,NN 


JPE 


NN 


EA 


JP 


PE,NN 


JPO 


NN 


E2 


JP 


PO,NN 


JZ 


NN 


CA 


JP 


Z,NN 


LDA 


NN 


3A 


LD 


A,(NN) 


LDAX 


B 


OA 


LD 


A,(BC) 


LDAX 


D 


26 


LD 


A,(DE) 


LHLD 


NN 


2A 


LD 


HL,(NN) 


LXI 


B,NN 


01 


LD 


BC,NN 


LXI 


D,NN 


11 


LD 


DE,NN 


LXI 


H,NN 


21 


LD 


HL,NN 


LXI 


SP,NN 


31 


LD 


SP,NN 


MOV 


M,R 





LD 


(HL),R 


MOV 


R,M 





LD 


R,(HL) 


MOV 


R,R2 





LD 


R,R2 


MVI 


M,N 


36 


LD 


(HL),N 


MVI 


R,N 




LD 


R,N 


NOP 




00 


NOP 


ORA 


M 


B6 


OR 


(HL) 


ORA 


R 


B- 


OR 


R 


ORI 


N 


F6 


OR 


N 


OUT 


N 


D3 


OUT 


(N),A 
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8080 


HEX 




Z-80 


code 


code 




code 


PCHL 


E9 


JP 


(HL) 


POP B 


CI 


POP 


BC 


POP D 


Dl 


POP 


DE 


POP H 


El 


POP 


HL 


POP PSW 


Fl 


POP 


AF 


PUSH B 


C5 


PUSH 


BC 


PUSH D 


D5 


PUSH 


DE 


PUSH H 


E5 


PUSH 


HL 


PUSH PSW 


F5 


PUSH 


AF 


RAL 


17 


RLA 




RAR 


IF 


RRA 




RC 


D8 


RET 


C 


RET 


C9 


RET 




RLC 


07 


RLCA 




RM 


F8 


RET 


M 


RNC 


DO 


RET 


NC 


RNZ 


CO 


RET 


NZ 


RP 


FO 


RET 


p 


RPE 


E8 


RET 


PE 


RPO 


EO 


RET 


PO 


RRC 


15 


RRCA 




RST 


C7 


RST 





RST 1 


CF 


RST 


8 


RST 2 


D7 


RST 


lOH 


RST 3 


DF 


RST 


18H 


RST 4 


E7 


RST 


20H 


RST 5 


EP 


RST 


28H 


RST 6 


F7 


RST 


30H 


RST 7 


FF 


RST 


38H 


RZ 


C8 


RET 


Z 


SBB M 


9E 


SBC 


A,(HL) 


SBB R 


9- 


SBC 


A,R 


SBI N 


DE 


SBC 


A,N 


SHLD NN 


22 


LD 


(NN),HL 


SPHL 


F9 


LD 


SP,HL 


STA NN 


32 


LD 


(NN),A 


STAX B 


02 


LD 


(BC),A 


STAX D 


12 


LD 


(DE),A 


STC 


37 


SCF 




SUB M 


96 


SUB 


(HL) 


SUB R 


9- 


SUB 


R 


SUI N 


D6 


SUB 


N 


XCHG 


EB 


EX 


DE,HL 


XRA M 


AE 


XOR 


(HL) 


XRA R 


A- 


XOR 


R 


XRI N 


EE 


XOR 


N 


XTHL 


E3 


EX 


(SP),HL 



APPENDIX H 

Details of the Z-80 
and 8080 Instruction Set 



A summary of the Z-80 and 8080 instruction set is given in this appendix.* 
The instructions are listed alphabetically by the official Zilog mnemonic. If 
there is a corresponding 8080 instruction, the Intel mnemonic is shown in 
angle brackets; if not, "no 8080" is shown in the angle brackets. The Z-80 
mnemonics are listed in numeric order in Appendix F. The Z-80 equivalent 
of an 8080 mnemonic can be found from the cross-reference given in 
Appendix G. 

The letters A, B, C, D, E, H, I, L, IX, lY, R, and SP are used for the 
standard Z-80 register names. In addition, the symbols BC, DE, and HL are 
used for the register pairs. The following symbols are used for general 
arguments. 

r, r2 8-bit CPU register 
dd 8-bit signed displacement 
nn general 8-bit constant 
nnnn 16-bit constant 

The flag bits are represented by: 

C carry 

H half carry 

N add/subtract 

P/O parity/overflow 

S sign 

Z zero 

Pointers to memory or input or output addresses are enclosed in parentheses. 



*More details can be obtained from the Zilog programmer's manual, Z-80 Assembly 
Language Programming Manual, Zilog, Inc., 1977. 
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ADC A»<HL) <AnC H> 

Add the memory byte pointed to by the HL register pair to the accumulator 
and the carry flag. The result is placed in the accumulator. 

Flags affected: C, H, O, S, Z 
Flag reset: N 



ADC A»(IX+dd) <rio 8080> 

ADC A>(IY+dd) <no 8080> 

Add the memory byte referenced by the sum of the specified index register 
and the displacement to the accumulator and the carry flag. The result is 
placed in the accumulator. 

Flags affected: C, H, O, S, Z 
Flag reset: N 



ADC A?r <ADC r> 

Add the value in register r to the accumulator and the carry flag. The result 
is placed in the accumulator. 

Flags affected: C, H, O, S, Z, 
Flags reset: N 



ADC A»rin <ACI nri> 

Add the constant given in the second operand to the accumulator and the 
carry flag. The result is placed in the accumulator. 

Flags affected: C, H, O, S, Z 
Flag reset: N 



ADC HLfBC <no 8080> 

ADC HL»DE <no 8080> 

ADC HLfHL <no 8080> 

ADC HL»SP <no 8080> 



Add the indicated double register to the HL register and the carry flag. The 
result is placed in HL. 

Flags affected: C, H, O, S, Z, 
Flag reset: N 



ADD A»<HL) <ADD M> 

Add the memory byte pointed to by the HL pair to the accumulator. The 
result is placed in the accumulator. 

Flags affected: C, H, O, S, Z 
Flag reset: N 
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ADD 
ADD 



Af <IY+dd) 



<no 8080> 
<no 8080> 



Add the memory byte pointed to by the sum of the specified index register 
and the displacement to the accumulator. The result is placed in the accumu- 
lator. 

Flags affected: C, H, O, S, Z 
Flag reset: N 



ADD Af r <ADD r> 

Add the value in register r to the accumulator. The result is placed in the 
accumulator. 

Flags affected: C, H, O, S, Z 
Flag reset: N 



ADD Arnn <ADI nn> 

Add the immediate byte (the second operand) to the accumulator. The 
result is placed in A. 

Flags affected: C, H, O, S, Z 
Flag reset: N 



ADD 


HLfDC 


<DAD 


B> 


ADD 


HLrDE 


<DAD 


D> 


ADD 


HL;HL 


<DAD 


H> 


ADD 


HL.SP 


<DAD 


SP> 



Add the specified double register to the HL pair. The result is placed in HL. 
This is a double-precision addition. The carry flag is set if an overflow 
occurs. The instruction ADD HL,HL performs a 16-bit arithmetic shift left, 
effectively doubling the value in HL. The ADD HL,SP instruction can be 
used with the 8080 CPU to save an incoming stack pointer: 



LXI 

DAD 

SHLD 



H,0 
SP 



nnnn 



Flags affected: C, H, O, S, Z 
Flag reset: N 



ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 



IXf BC 
IXrDE 
IX»IX 
IX»SP 
IY»BC 
IY»DE 
IY»IY 
IYjSP 



<no 
<rio 
<no 
<no 
<no 
<no 
<no 
<no 



8080> 
8000> 
8080> 
8080> 
8080> 
8080> 
8080> 
8080> 
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Add the indicated double register to the specified index register. The result 
is placed in the index register. The HL register pair does not participate in 
this group of instructions. Notice that there is no equivalent series of ADC 
instructions. 

Flags affected: C, O, S, Z 
Flag reset: N 



AND (HL) <ANA M> 

Perform a logical AND with the accumulator and the memory location 
pointed to by the HL register pair. The result is placed in the accumulator. 

Flags affected: P, S, Z 
Flags reset: C, N 
Flag set: H 



AND (IX+dd) <no 8080> 

AND (lY+dd) <no 8080> 

Perform a logical AND with the accumulator and the memory byte refer- 
enced by the sum of the index register and displacement. The result is 
placed in the accumulator. 

Flags affected: P, S, Z 
Flags reset: C, N 
Flag set: H 



AND r <ANA r> 

Perform a logical AND with the accumulator and register r. The result is 
placed in the accumulator. An instruction AND A is an effective way to test 
the parity, sign, and zero flags. 

Flags affected: P, S, Z 
Flags reset: C, N 
Flag set: H 



AND nn " <ANI nn> 

Perform a logical AND with the accumulator and the constant given in the 
argument. The result is placed in the accumulator. This instruction can be 
used to selectively reset bits of the accumulator. For example, the instruc- 
tion AND 7FH will reset bit 7. 



Flags affected: P, S, Z 
Flags reset: C, N 
Flag set: H 
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BIT 
BIT 
BIT 



b? (HL) 
b» <IX+dd) 
bf < lYfdd) 



<no 8080> 
<rio 8080> 
<no 8080> 



Test bit b of the memory byte referenced by the second operand. Bit b can 
range from zero through 7. The zero flag is set if the referenced bit is a 
logical 1 ; otherwise, it is reset. Thus, the zero flag becomes the complement 
of the selected bit. 

Flag affected: Z 
Flag set: H 
Flag reset: N 



BIT bfr <no 8080> 

Test bit b of register r, where b can range from zero through 7. The zero flag 
is set if the referenced bit is a logical 1. It is reset otherwise. 

Flag affected: Z 
Flag set: H 
Flag reset: N 



CALL nnnn <CALL nnnn> 

Unconditional subroutine call to address nnnn. The address of the following 
instruction is pushed onto the stack. 

Flags affected: none 



CALL 


C > nnnri 


<CC 


nnnn> 


CALL 


H 9 nnnn 


<CH 


nnnn> 


CALL 


NC s nnnn 


<CNC 


nnnn> 


CALL 


NZpnnnn 


<CNZ 


nnnn> 


CALL 


Pf nnnn 


<GP 


nnnn> 


CALL 


PE f nnnn 




nnnn> 


CALL 


POjnnnn 


<CPO 


nnnn> 


CALL 


Zfnnnn 


<cz 


nnnn> 



Conditional subroutine call to address nnnn. The address of the following 
instruction is pushed onto the stack. The conditions are: 



C 

M 

NC 

NZ 

P 

PE 
PO 
Z 



carry flag set 
sign flag set 



carry flag reset 
zero flag reset 
sign flag reset 
parity flag set 
parity flag reset 
zero flag set 



(not carry) 
(not zero) 
(plus) 

(parity even) 
(parity odd) 
(zero) 



(carry) 
(minus) 
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CCF < CMC > 

Complement the carry flag. This instruction can be given after a SCF com- 
mand to reset the carry flag. 

Flag affected: C 
Flag reset: N 



CP <HL) <CMP M> 

Compare the byte in memory pointed to by the HL pair to the accumulator 
(an implied operand). The zero flag is set if the accumulator is equal to the 
operand. The carry flag is set if the accumulator is smedler than the operand. 

Flags affected: C, H, O, S, Z 
Flag set: N 



CP (IX+dd) <no 8080> 

CP (lY+dd) <no 8080> 

Compare the memory location referenced by the sum of the index register 
and displacement to the accumulator which is an implied operand. The zero 
flag is set if the accumulator is equal to the operand. The carry flag is set if 
the accumulator is smaller than the operand. 

Flags affected: C, H, O, S, Z 
Flag set: N 



CP r <CMP r> 

Compare register r to the accumulator, which is an implied operand. The 
zero flag is set if the accumulator is equal to the operand. The carry flag is 
set if the accumulator is smaller than the operand. 

Flags affected: C, H, O, S, Z 
Flag set: N 



CP nn <CPI nn> 

Compare the constant given in the operand to the accumulator, which is an 
implied operand. The zero flag is set if the accumulator is equal to the 
operand. The carry flag is set if the accumulator is smaller than the operand. 

Flags affected: C, H, O, S, Z 
Flag set: N 



CPD <no 8080> 

CPDR <no 8080> 

CP I <no 8080> 

CPIR <no 8080> 
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Compare the memory byte pointed to by HL to the accumulator. Decrement 
HL (if D) or increment HL (if I). Decrement the byte count in the BC regis- 
ter. Repeat the operation for CPDR and CPIR until a match is found or 
until the BC register pair has been decremented to zero. The zero flag is set 
if a match is found. The parity flag is set if BC is decremented to zero. 

Flags affected: H, S 

Flags set: N, Z if A = (HL), P if BC = 



CPL < CMA > 

Complement the accumulator. This instruction performs a one's comple- 
ment on the accumulator. (Compare to the instruction NEG.) 

Flags set: H, N 



DAA < DAA > 

Decimal adjust the accumulator. This instruction is used after each addition 
with BCD numbers. The Z-80 performs this operation properly for both 
addition and subtraction. The 8080, however, gives an incorrect result for 
subtraction. 

Flags affected: O, S, Z, C, H 



DEC (HL) <DCR M> 

Decrement the memory byte pointed to by the HL register pair. 

Flags affected: H, O, S, Z 

Flag set: N 

Flag not affected: C 



DEC <IX+dd) <no 8080> 

DEC (lY+dd) <no 8080> 

Decrement the memory byte pointed to by the sum of the index register 
and the displacement. 

Flags affected: H, O, S, Z 

Flag set: N 

Flag not affected: C 



DEC r <DCR r> 

Decrement the register r. Don't try to decrement a register past zero while 
executing a JP NC loop. The carry flag is not affected by this operation. 

Flags affected: H, O, S, Z 

Flag set: N 

Flag not affected: C 
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DEC 


DC 


<DCX 


B> 


DEC 


DE 


<DCX 


D> 


DEC 


HL 


<DCX 


H> 


DEC 


SP 


<DCX 


SF'> 



Decrement the indicated double register. Don't try to decrement a double 
register to zero in a JP NZ loop. It won't work since this operation does not 
affect any of the PSW flags. Instead, move one byte of the double register 
into the accumulator and perform a logical OR with the other byte. 

LD A,C 

OR B 

JR NZ,nnnn 

Flags affected: none!!!! 



DEC IX <no 8080> 

DEC lY <no 8080> 

Decrement the index register. 

Flags affected: none 



DI < DI > 

Disable maskable interrupt request. 



DJN2 dd <no 8080> 

Decrement register B and jump relative to displacement dd if B register is 
not zero. 

Flags affected : none 



EI < EI > 

Enable maskable interrupt request. 



EX (SP)fHL < XTHL > 

Exchange the byte at the stack pointer with register L. Exchange the byte at 
the stack pointer + 1 with register H. 

Flags affected: none 



EX <SP)»IX <no 8080> 

EX <SP)!.IY <no 8080> 

Exchange the 16 bits referenced by the stack pointer with the specified 
index register. 

Flags affected: none 



APPENDIX H 291 



EX AFf AF' <no 8080> 

Exchange the accumulator and flag register with the alternate set. 
Flags affected: all 



EX DE>HL < XCHG > 

Exchange the double registers DE and HL. 
Flags affected: none 



EXX <no 8080> 

Exchange BC, DE, and HL with the alternate set. 
Flags affected: none 



HALT < HLT > 

Suspend operation of the CPU until a reset or interrupt occurs. Dynamic 
memory refresh continues during a halt. 



IM <no 8080> 

IH 1 <no 8080> 

IM 2 <no 8080> 

Sets interrupt mode 0, 1, or 2. Interrupt mode is automatically selected 
when a Z-80 reset occurs. The result is the same as the 8080 interrupt 
response. Interrupt mode 1 performs an RST 38H instruction. Interrupt 
mode 2 provides for many interrupt locations. 



IN Tf<C) <no 8080> 

9 

Input a byte from the port address in register C to register r. 

Flags affected: P, S, Z 
Flags reset: H, N 

IN Af (nn) <IN nn> 

Input a byte from the port address nn to the accumulator. 
Flags affected: none 



INC (HL) <INR M> 

Increment the memory byte pointed to by the HL pair. 

Flags affected: H, O, S, Z 
Flag set: N 

Flag not affected. C!!!! 
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INC (IX+dd) <no 8080> 

INC (lY+dd) <no 8080> 

Increment the memory byte pointed to by the sum of the index register and 
the displacement. 

Flags affected: H, O, S, Z 
Flag set: N 

Flag not affected: C!!! 



INC r <INR r> 

Increment the 8-bit register r. Don't try to increment a register past zero 
while executing a JP NC loop. It won't work because the carry flag is unaf- 
fected by this instruction. 

Flags affected: H, O, S, Z 
Flag set: N 

Flag not affected: C!!! 



INC 


BC 


<INX 


B> 


INC 


OE 


<INX 


B> 


INC 


HL 


<INX 


H> 


INC 


SP 


<INX 


SP> 



Increment the specified double register. 
Flags affected : none ! ! ! ! 



INC IX <no 8080> 

INC lY <rio 8080> 

Increment the specified index register. 
Flags affected: none 



INB <no 8080> 

INBR <no 8080> 

INI <no 8080> 

INIR <no 8080> 

Input a byte from the port address in register C to the memory byte pointed 
to by HL. Decrement register B. The HL register is incremented (if I) or 
decremented (if D). For INDR and INIR the process is repeated until the 
8-bit register B becomes zero. 

Flag affected: Z (if B = 0) 
Flag set: N 
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JP (HL) < PCHL > 

Copy the HL register pair into the program counter; then retrieve the next 
instruction from the address referenced by HL. This instruction causes a 
jump to the address referenced by HL. 

Flags affected: none 



JP <IX) <no 8080> 

JP <1Y> <no 8080> 

Copy the contents of the specified index register into the program counter; 
then retrieve the next instruction from the address referenced by IX or lY. 

Flags affected: none 



JP nnnn <JMP nnnn> 

Unconditional jump to address nnnn. 
Flags affected: none 



JP 


C»nnnn 


<JC 


nnnn> 


JP 


Mf-nnnn 


<JM 


nnnn> 


JP 


NC?nnnn 


<JNC 


nnnn> 


JP 


NZf nnnn 


<JNZ 


nnnn> 


JP 


P t nnnn 


<JP 


nnnn> 


JP 


PE»nnnn 


<JPE 


nnnn> 


JP 


POfnnnn 


<JPO 


nnnn> 


JP 


Z > nnnn 


<JZ 


nnnn> 



Conditional jump to address nnnn where: 



c 


means carry flag set 


(carry) 


M 


means sign flag set 


(minus) 


NC 


means carry flag reset 


(not carry) 


NZ 


means zero flag reset 


(not zero) 


P 


means sign flag reset 


(plus) 


PE 


means parity flag set 


(parity even) 


PO 


means parity flag reset 


(parity odd) 


Z 


means zero flag set 


(zero) 



JR dd <no 8080> 

Unconditional relative jump with a signed displacement nn. The jump is 
limited to 129 bytes forward and 126 bytes backward in memory. 

Flags affected: none 
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JR C»cid <no 8080> 

JR NCfdd <no 8080> 

JR NZi-dd <no 8080> 

JR Z»dd <no 8080> 



Conditional relative jump to address nn where: 

C means carry flag set (carry) 

NC means carry flag reset (not carry) 

NZ means zero flag reset (not zero) 

Z means zero flag set (zero) 



LD <BC)»A <STAX B> 

LD (DE)fA <STAX D> 

Move the byte in the accumulator to the memory byte referenced by the 
specified register pair. 



L0 <HL)?r <MOV Hpr> 

Move the byte in register r to the memory byte pointed to by the HL pair. 



LD (HL)fnn <MVI Mrnn> 

Move the immediate byte nn into the memory byte referenced by the HL 
pair. 



LD < IX+dd) f r <no 8080> 

LD <IX-fdd) fnn <no 8080> 

LD {IY+dd)»r <r,o 8080> 

LD <IY+dd) »nn 

Move the byte in register r or the immediate byte nn into the memory byte 
referenced by the sum of the index register plus the displacement. These 
instructions can be used to load relocatable binary code. 



LD <nnnn) » A <STA nnnn> 

Store the accumulator in the memory location referenced by nnnn. 



LD (nnnn)i>BC <no 8080> 

LD (nnnn)fDE <no 8080> 

Store the low-order byte (C or E) of the specified double register at the 
memory location nnnn. Store the high-order byte (B or D) at nnnn 4- 1. 



LD (nnnn) »HL <SHLD nnnn> 

Store register L at the memory address nnnn. Store register H at the address 
nnnn + 1. 
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LD (nnnn>»IX <no 8080> 

LD <nnnn),IY <no 8080> 

LD <nnnn)»SP <no 8080> 



Store the low-order byte of the specified register IX, lY, or SP at the 
location nnnn. Store the high-order byte at nnnn + 1. The instruction 
LD {nnnn),SP can be used to temporarily save an incoming stack pointer. It 
can later be restored by a LD SP,(nnnn) operation. 



LD Af(BC) <LDAX B> 

LD AHDE) <LDAX D> 

Move the memory byte referenced by the specified register pair BC or DE 
into the accumulator. 



LD A»I <no 8080> 

Load the accumulator from the interrupt-vector register. The parity flag 
reflects the state of the interrupt-enable flip-flop. 

Flags affected: S, Z, P 
Flags reset: H, N 

LD A>R <no 8080> 

Load the accumulator from the memory-refresh register. The parity flag 
reflects the state of the interrupt-enable flip-flop. This is an easy way to 
obtain a fairly decent random number. 

Flags affected: S, Z, P , 
Flags reset: H, N 

LD I'A 8080> 

Copy the accumulator into the interrupt-vector register. 
Flags affected: none 

LD Ri-A <no 8080> 

Copy the accumular into memory-refresh register. 
Flags affected: none 



LD r> (HL) <HOV rfM> 

Move the byte in the memory location pointed to by the HL register pair 
into register r. 
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LD rF<IX+dd) <no 8080> 

LD rs-dY+dd) <no 8080> 

Move the byte at the memory location referenced by the sum of the index 
register and the displacement into register r. 

LD r»r2 <HOV r»r2> 

Move the byte from register r2 to r. 

LD rmn <MVI r»nn> 

Load register r with the 8-bit data byte nn. 



LD A>(nnnn> <LDA nrinn> 

Load the accumulator from the memory byte referenced by the 16-bit 
pointer nnnn. 



LD BCf<nnnr») <no 8080> 

LD DEi-<nnnn) <no 8080> 

Load the low-order byte (C or E) from the location referenced by the 16-bit 
pointer nnnn. Load the high-order byte (B or D) from nnnn + 1. 



LD HL» (nnnn) <LHLD nnnn> 

Load register L from the address referenced by the 16-bit value nnnn. Load 
register H from the address nnnn + 1. 



LD DC f nnnn <LXI B»nnnn> 

LD DE»nnnn , <LXI D»nnnn> 

LD HL»nnnn <LXI H»nnnn> 

LD SP f nnnn <LXI SP?nnnn> 

LD IX » nnnn <no 8080> 

LD IY»nnnn <no B080> 



Load the specified double register with the 16-bit constant nnnn. Be careful 
not to confuse LD HL,(nnnn) with LD HL,nnnn. 



LD IX f (nnnn) <no 8080> 

LD lYf (nnnn) <no 8080> 

LD SPf (nnnn) <no 8080> 

Load the low byte of IX, lY, or SP from the memory location nnnn. Load 
the high byte from nnnn + 1. The LD SP,(nnnn) instruction can be used to 
retrieve a previously saved stack pointer. 
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LB SP»HL < SPHL > 

LB SPfIX <nio 8080> 

LD SPjIY <no 8080> 

Load the stack pointer from the specified 16-bit register. The SPHL instruc- 
tion can be used to retrieve a previously saved stack pointer when the 8080 
CPU is used. 

LHLD nnnn 
SPHL 



LDD <no 8080> 

LDDR <no 8080> 

LDI <no 8080> 

LDIR <no 8080> 



Move the byte referenced by the HL pair into the location pointed to by 
the DE register pair. Decrement the 16-bit byte counter in BC. Increment 
(if I) or decrement (if D) both HL and DE. Repeat the operation for LDDR 
and LDIR until the BC register has been decremented to zero. 



NE6 <no 8080> 

This instruction performs a two's complement on the accumulator. It 
effectively subtracts the accumulator from zero. To perform this task on an 
8080, use a CMA command followed by an INR A command. 

Flags affected: all 



NOP < NOP > 

No operation is performed by the CPU. 
Flags affected: none 



OR (HL) <ORA H> 

Perform a logical OR with the accumulator and the byte referenced by HL. 
The result is placed in the accumulator. 

Flags affected: P, S, Z 
Flags reset: C, H, N 



OR <IX^-dd> <rio 8080> 

OR (lY+dd) <no 8080> 

Perform a logical OR with the accumulator and the byte referenced by the 
specified index register plus the displacement. The result is placed in the 
accumulator. 

Flags affected: P, S, Z 
Flags reset: C, H, N 
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OR r <ORA r> 

Perform a logical OR with the accumulator and the register r. The result is 
placed in the accumulator. An instruction of OR A is an efficient way to 
test the parity, sign, and zero flags. 

Flags affected: P, S, Z 
Flags reset: C, H, N 



OR nn <ORI nri> 

Perform a logical OR with the accumulator and the byte nn. The result is 
placed in the accumulator. This instruction can be used to set individual bits 
of the accumulator. For example, OR 20H will set bit 5 to a logical 1. 

Flags affected: P, S, Z 
Flags reset: C, H, N 



OTDR <no 8080> 

OTIR <no 8080 

Output a byte from the memory location pointed to by the HL pair. The 
port address is contained in register C. Register B is decremented. The HL 
register pair is incremented (if I) or decremented (if D). The process is 
repeated until register B has become zero. 

Flags set: N, Z 



OUT (C)»r <rio 8080> 

Output the byte in register r to the port address contained in register C. 
Flags affected: none 



OUT <nn)»A <OUT nri> 

Output the byte in the accumulator to the port address nn. 
Flags affected: none 



OUTD <no 8080> 

OUT I <no 8080> 

Output a byte from the memory location pointed to by the HL pair. The 
port address is contained in register C. Register B is decremented. The HL 
register pair is incremented (if I) or decremented (if D). 

Flag affected: Z 
Flag set: N 
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POP AF <POP PSW> 

Move the byte at the memory location referenced by the stack pointer into 
the flag register (PSW), and increment the stack pointer. Then move the 
byte at the location referenced by the new stack-pointer value into the 
accumulator and increment the stack pointer a second time. 

Flags affected: all 



POP BC <POP B> 

POP DE <POP D> 

POP HL <POP H> 

Copy two bytes of memory into the appropriate double register as follows. 
The memory byte referenced by the stack pointer is moved into the low- 
order byte (C, E, or L), then the stack pointer is incremented. The memory 
byte referenced by the new stack pointer is then moved into the high-order 
byte (B, D, or H). The stack pointer is incremented a second time. 

Flags affected: none 



POP IX <no 8080> 

POP lY <no 8080> 

Copy the top of the stack into the specified index register. Increment the 
stack pointer twice. 

Flags affected: none 



PUSH AF <PUSH PSW> 

Store the accumulator and flag register in memory as follows. The stack 
pointer is decremented, then the value in the accumulator is moved to the 
memory byte referenced by the stack pointer. The stack pointer is decre- 
mented a second time. The flag register is copied to the byte at the memory 
address referenced by the current stack-pointer position. 

Flags affected: none 



PUSH BC <PUSH B> 

PUSH DE <PUSH D> 

PUSH HL <PUSH H> 

Store the referenced double register in memory as follows. The stack pointer 
is decremented, then the byte in the specified high-order register B, D, or H 
is copied to the memory location referenced by the stack pointer. The stack 
pointer is decremented a second time. The byte in the low-order position C, 
E, or L is moved to the byte referenced by the current value of the stack 
pointer. 

Flags affected: none 
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PUSH IX <no 8080> 

PUSH lY <no 8080> 

The indicated index register is copied to the top of the stack. The stack 
pointer is decremented twice. 

Flags affected: none 



RES b»(HL) <no 8080> 

RES b»(IX+dd) <no 8080> 

RES b»(IY+cld) <no 8080> 

Reset bit b of the memory byte referenced by the second operand. Bit b 
can range from zero through 7. 

Flag reset: N 

Other flags affected: none 



RES b»r <no 8080> 

Reset bit b of register r to a value of zero. Bit b can range from zero through 7. 

Flag reset: N 

Other flags affected: none 



RET < RET > 

Return from a subroutine. The top of the stack is moved into the program 
counter. The stack pointer is incremented twice. 



RET 


C 


< 


RC > 


RET 


M 


< 


RM > 


RET 


NC 


<! 


RNC > 


RET 


NZ 


< 


RNZ > 


RET 


P 


< 


RP > 


RET 


PE 


< 


RPE > 


RET 


PO 




RPO > 


RET 


Z 


< 


RZ > 



Conditional return from a subroutine. If the condition is met, the top of 
the stack is moved into the program counter. The stack pointer is incre- 
mented twice. 



c 


means carry flag set 


(carry) 


M 


means sign flag set 


(minus) 


NC 


means carry flag reset 


(not carry) 


NZ 


means zero flag reset 


(not zero) 


P 


means sign flag reset 


(plus) 


PE 


means parity flag set 


(parity even) 


PO 


means parity flag reset 


(parity odd) 


Z 


means zero flag set 


(zero) 
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RETI <no 8080> 

Return from maskable interrupt. 



RETN <no 8080> 

Return from nonmaskable interrupt. 



The following RL and RLA instructions rotate bits to the left through carry. 



! ! I I I j I I 1 ). 

! ! < <_ <_ <_ ^_ ^_ 

! ! I ! j I ! I ! j. 

carra register 



RL <HL> <no 8080> 

The memory byte referenced by the HL pair is rotated left through carry. 
The carry flag moves into bit zero. Bit 7 moves to the carry flag. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RL (IX+dd) <no 8080> 

RL <IYidd) <no 8080> 

The memory byte referenced by the sum of the index register and the dis- 
placement is rotated left through carry. The carry flag moves into bit zero. 
Bit 7 moves to the carry flag. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RL r <no 8080> 

The byte in register r is rotated left through carry. The carry flag moves into 
bit zero. Bit 7 moves to the carry flag. Note: the instruction RL A performs 
the same task that the separate instruction RLA does, but the former takes 
twice as long as the latter. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RLA < RAL > 

The byte in the accumulator is rotated left through carry. The carry flag 
moves to bit zero. Bit 7 of the accumulator moves to the carry flag. 
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Flag affected: C 
Flags reset: H, N 



The following RLC and RLCA instructions rotate bits to the left. 
!-> 

1 j 

carry 



RLC (HL) <no 8080> 

The byte referenced by the HL pair is rotated left circularly. Bit 7 moves to 
both the zero bit and to the carry flag. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RLC <IX+dci> <no 8080> 

RLC (lY-frdd) <no 8080> 

The byte referenced by the specified index register plus the displacement is 
rotated left circularly. Bit 7 moves to both bit zero and the carry flag. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RLC r <no 8080> 

The byte in register r is rotated left circularly. Bit 7 moves to both bit zero 
and the carry flag. Note: RLC A performs the same task that another in- 
struction RLCA does, but the former instruction takes twice as long as the 
latter. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RLCA < RLC > 

The accumulator is rotated left circularly. Bit 7 moves to both bit zero and 
the carry flag. 

Flag affected: C 
Flags reset: H, N 



RLD <no 8080> 

A 4-bit rotation over 12 bits. The low 4 bits of A move to the low 4 bits of 
the memory location referenced by the HL pair. The original low 4 bits of 



> y 

I I I- — ! ! j I I I 

-<- <- <- <- <~ <- <- <- <~ 
I I I I I I I I I 

register 
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memory move to the high 4 bits. The original high 4 bits move to the low 
4 bits of A. This instruction is used for BCD operations. 

Flags affected: P, S, Z 
Flags reset: H, N 



! — < <-! 



!~< <-• 



I ■ 



I - 



! 4 hits ! 4 bits 

I ! 

sccuiiiulstor ! 

I — 



! 4 bits 



4 bits 



memorv ! 
— > >-• 



The following RR and RRA instructions rotate bits to the right through 
carry. 



-> ~> -> -; 
.1 1 1 j. 

reaister 



-> i 

carra 



RR <HL) <no 8080> 

The memory byte pointed to by the HL pair is rotated right through carry. 
Carry moves to bit 7. Bit zero moves to the carry flag. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RR (IX-fdd) <no 8080> 

RR <IY+dd) <no 8080> 

The memory byte pointed to by the specified index register plus the offset 
is rotated right through carry. The carry flag moves to bit 7. Bit zero moves 
to the carry flag. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RR p <no 8080> 

The byte in register r is rotated right through carry. Carry moves to bit 7. 
Bit zero moves to the carry flag. Note: RR A performs the same task that 
another instruction RRA does, but the former instruction takes twice as 
long as the latter. 

Flags affected: C, P, S, Z 
Flags reset: H, N 
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RRA < RAR > 

The accumulator is rotated right through carry. The carry flag moves to 
bit 7. Bit zero moves to the carry flag. 

Flag affected: C 
Flags reset: H, N 



The following RRC and RRCA instructions rotate bits to the right. 

! < < <_! 

! ! 

I j I 1 1 1 1 J ! I ! 

! — > i -> -> -> -> -> -> -> -> — ! 
1 j I j J I I I I 

register 



RRC <HL) <no 8080> 

The memory byte pointed to by the HL pair is rotated right circularly. Bit 
zero moves to both the carry flag and bit 7. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RRC (IX+dd) <no 8080> 

RRC (lY+dc!) <no 8080> 

The memory byte pointed to by the index register plus the offset is rotated 
right circularly. Bit zero moves to both thei carry flag and bit 7. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RRC r <no 8080> 

The byte in register r is rotated right circularly. Bit zero moves to both the 
carry flag and bit 7. Note: RRC A performs the same task that another 
instruction RRCA does, but the former instruction takes twice as long as 
the latter. 

Flags affected: C, P, S, Z 
Flags reset: H, N 



RRCA < RRC > 

The accumulator is rotated right circularly. Bit zero moves to both the carry 
flag and bit 7. 

Flag affected: C 
Flags reset: H, N 



I i 

carra 
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RRD 



<no 8080> 



A 4-bit rotation over 12 bits. The low 4 bits of A move to the high 4 bits of 
the memory location referenced by the HL pair. The original high 4 bits of 
memory move to the low 4 bits. The original low 4 bits move to the low 4 
bits of A. This instruction is used for BCD operations. 

Flags affected: P, S, Z 
Flags reset: H, N 



! — >- 
I 



4 bits • 4 bits I 



Bccumulator 



i~>- 



->- ! 
I 



! 4 bits ! 4 bits 
I 1 



memoru 



RST OOH <RST 0> 

RST 08H <RST 1> 

RST lOH <RST 2> 

RST 18H <RST 3> 

RST 20H <RST 4> 

RST 28H <RST 5> 

RST 30H <RST 6> 

RST 38H <RST 7> 



These restart instructions generate one-byte subroutine calls to address given 
in the Z-80 operand. 



SBC A» (HL) <SBB M> 

Subtract the carry flag and the memory byte pointed to by the HL p£iir from 
the accumulator. The result is placed in the accumulator. Some Z-80 assem- 
blers allow the 8080 mnemonic of SBB to be used as an alternate Z-80 
mnemonic for this instruction. 

Flags affected: C, H, O, S, Z 
Flag set: N 



SBC Ar (IX+dd) <no 8080> 

SBC As-dY+dd) <no 8080> 

Subtract the carry flag and the memory byte pointed to by the sum of the 
index register and displacement from the accumulator. The result is placed 
in the accumulator. 

Flags affected: C, H, O, S, Z 
Flag set: N 
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SBC A»r <SBB r> 

Subtract the carry flag and the specified CPU register from the accumulator. 
The result is placed in the accumulator. Some Z-80 assemblers allow the 
8080 mnemonic of SBB to be used as an alternate Z-80 mnemonic for this 
instruction. 

Flags affected: C, H, O, S, Z 
Flag set: N 



SBC Ajnn <SBI nn> 

Subtract the immediate byte (the second operand) and the carry flag from 
the accumulator. The result is placed in the accumulator. Some Z-80 assem- 
blers allow the 8080 mnemonic of SBB to be used as an alternate Z-80 mne- 
monic for this instruction. 

Flags affected: C, H, O, S, Z 
Flag set: N 



SBC HLrBC <no 8080> 

SBC HLpDE <no 8080> 

SBC HL^HL <no 8080> 

SBC HL»SP <no 8080> 

Subtract the specified CPU double register and the carry flag from the HL 
register pair. The result is placed in HL. You may need to reset the carry 
flag with an OR A operation before using these instructions. 

Flags affected: C, H, O, S, Z 
Flag set: N 



SCF < STC > 

Set the carry flag. There is no equivalent reset command. However, the carry 
flag can be reset with the XOR A instruction, or with the pair of instruc- 
tions SCF and CCF. 

Bit set: C 

Bits reset: H, N 



SET b?<HL) <rio 8080> 

SET bf<IX+dd) <no 8080> 

SET bf<IY+dcl) <no 8080> 

Set bit b of the memory byte referenced by the second operand. Bit b can 
range from zero through 7. 

Flag reset: N 

Other flags affected: none 
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SET bsr <no 8080> 

Set bit b of register r. Bit b can range from zero through 7. 
Flag reset: N 

Other flags affected: none 



The following SLA instructions shift bits to the left. 

I j I j J j 1 1 1 j 1 

! ! < <_ <- <_ <_ <_ <_ <- ! < — 

I j I j I I I I I ! I 

carrw register 



SLA <HL) <rio 8080> 

Perform an arithmetic shift left on the memory byte pointed to by the HL 
pair. Bit 7 is moved to the carry flag. A zero is moved into bit zero. This 
operation doubles the original value. 

Bits affected: C, P, S, Z 
Bits reset: H, N 



SLA <IX+dd> <r.o 8080> 

SLA (lY+dd) <no 8080> 

Perform an arithmetic shift left on the memory byte pointed to by the index 
register plus the displacement. Bit 7 is moved to the carry flag. A zero is 
moved into bit zero. This operation doubles the original value. 

Bits affected: C, P, S, Z 
Bits reset: H, N 



SLA r <no 8080> 

Perform an arithmetic shift left on register r. Bit 7 is moved to the carry 
flag. A zero is moved into bit zero. This operation doubles the original value. 
Note: SLA A performs the same task that another instruction ADD A, A 
does, but the former instruction takes twice as long as the latter. 

Bits affected: C, P, S, Z 
Bits reset: H, N 



The following SRA instructions shift bits to the right. 



j — > ! _> _> -.> _> -; 
I 1 I I I I j. 

! ! register 

I < ! 



. j I I 

-> -> ->- 
.1 I j 



carry 
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SRA (HL) <no 8080> 

Perform an arithmetic shift right on the memory byte pointed to by the HL 
pair. Bit zero moves to the carry flag. Bit 7 is duplicated in bit 6. 

Bits affected: C, P, S, Z 
Bits reset: H, N 



SRA (IX+dd) <no 8080> 

SRA (lY+dd) <no 8080> 

Perform an arithmetic shift right on the byte pointed to by the index register 
plus the displacement. Bit zero moves to carry and bit 7 is duplicated into 
bite. 

Bits affected: C, P, S, Z 
Bits reset: H, N 



SRA r <no 8080> 

Perform an arithmetic shift right on register r. Bit zero moves to carry and 
bit 7 is duplicated into bit 6. The operation effectively halves the register 
value. The carry flag represents the remainder. The carry flag is set if the 
original number was odd. 

Bits affected: C, P, S, Z 
Bits reset: H, N 



The following SRL instructions shift bits to the right. 

I 1 1 1 j 1 _ — I j 

— > ! -> ~> -> -> -> -> -> 
! — ! 1 ! j j I j 

register 



SRL (HL) <no 8080> 

Perform a logical shift right on the byte pointed to by the HL register pair. 
A zero bit is moved into bit 7. Bit zero moves to the carry flag. 

Bits affected: C, P, Z 
Bits reset: H, N, S 



SRL < IX+dd) <no 8080> 

SRL <IY+dd) <no 8080> 

Perform a logical shift right on the byte pointed to by the index register 
plus the displacement. A zero bit is moved into bit 7. Bit zero moves to the 
carry flag. 



I I ! 

-> > f ! 

car ra 
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Bits affected: C, P, Z 
Bits reset: H, N, S 



SRL r <no 8080> 

Perform a logical shift right on register r. A zero bit is moved into bit 7. 
Bit zero moves to the carry flag. 

Bits affected: C, P, S, Z 
Bits reset: H, N 



SUB <HL) <SUB M> 

Subtract the memory byte referenced by the HL pair from the accumulator. 
The result is placed in the accumulator. 

Flags affected: C, H, O, S, Z 
Flag set: N 



SUB (IX+dd) <no 8080> 

SUB <IY+dci) <no 8080> 

Subtract the memory byte referenced by the index register plus the dis- 
placement from the value in the accumulator. The result is placed in A. 

Flags affected: C, H, O, S, Z 
Flag set: N 



SUB r <SUB r> 

Subtract the specified CPU register from the accumulator. The result is 
placed in the accumulator. Notice that Z-80 SUB mnemonic has only one 
operand, whereas there are two operands in the corresponding 8-bit ADC, 
ADD, and SBC mnemonics. The destination operand for all four of these 
instructions is always the accumulator. Consequently, the first operand is 
optional with some assemblers. 

Flags affected: C, H, O, S, Z 
Flag-set: N 



SUB nn <SUI nn> 

Subtract the immediate byte nn from the accumulator. The result is placed 
in the accumulator. 

Flags affected: C, H, O, S, Z 
Flag set: N 
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XOR <HL) <XRA M> 

Perform a logical exclusive OR with the accumulator and the byte referenced 
by the HL pair. The result is placed in the accumulator. 

Flags affected: P, S, Z 
Flags reset: C, H, N 



XOR <IX+dd) <no 8080> 

XOR <IY+dd) <no 8080> 

Perform a logical exclusive OR with the accumulator and the byte referenced 
by the sum of specified index register and the displacement. The result is 
placed in the accumulator. 

Flags affected: P, S, Z 
Flags reset: C, H, N 



XOR p <XRA r> 

Perform a logical exclusive OR with the accumulator and register r. The 
result is placed in the accumulator. The XOR A instruction is an efficient 
way to zero the accumulator, although all the flags are then reset. XOR A is 
also used to reset the carry flag. 

Flags affected: P, S, Z 
Flags reset: C, H, N 



XOR nn <XR1 nn> 

Perform a logical exclusive OR with the accumulator and the byte nn. The 
result is placed in the accumulator. 

Flags affected: P, S, Z 
Flags reset: C, H, N 



APPENDIX I 

Abbreviations and Acronyms 



A/D 


Analogue to Digital 


APL 


A Programming Language 


ASCII 


American Standard Code for Information Interchange 


BCD 


Binary -Coded Decimal 


BDOS 


Basic Disk-Operating System (CP/M) 


BIOS 


Basic Input/Output System (CP/M) 


Bit 


Binary digiT 


BJT 


Bipolar Junction Transistor 


GBlOb 


Customized Bios (CP/M) 


CCD 


Charge-Coupled Device 


CCP 


Console Command Processor (CP/M) 


CMUb 


Complementary Metal-Oxide Semiconductor 


K^KJDKJLi 


COmmon Business-Oriented Language 


PP /A/T 


Control Program for Microcomputers 


/~tTlT T 

CrU 


Central Processing Unit 


CRC 


Cyclical-Redundancy Check 


CRT 


Cathode Ray Tube 


CTS 


Clear To Send 


D/A 


Digital to Analogue 


DCD 


Data-Carrier Detect 


DDT 


Dynamic Debugging Tool (CP/M) 


DMA 


Direct Memory Access 


DOS 


Disk-Operating System 


ECL 


Emitter-Coupled Logic 


EOF 


End Of File 


EPROM 


Erasable PROM 


FCB 


File Control Block (CP/M) 


FDOS 


Full DOS (CP/M) 


FET 


Field-Effect Transistor 


FIFO 


First-In, First-Out 


FORTRAN 


FORmula TRANslation 


Hz 


Hertz (cycles per second) 


IC 


Integrated Circuit 


IGFET 


Insulated-Gate FET 



311 



312 8080/Z-80 ASSEMBLY LANGUAGE 



IIL 


Integrated Injection Logic 


I/O 


Input/Output 


JFET 


Junction FET 


LCD 


Liquid Crystal Display 


LED 


Light-Emitting Diode 


LIFO 


Last-In, First-Out 


LSB 


Least-Significant Bit (or Byte) 


LSI 


Large-Scale Integration 


MHz 


Megahertz (million Hz) 


MODEM 


MODulator/DEModulator 


MOS 


Metal-Oxide Semiconductor 


MOSFET 


MOS FET 


MSB 


Most Significant Bit (or Byte) 


NAND 


Not AND 


NOR 


Not OR 


OP AMP 


operational AMPlifier 


PIP 


Peripheral Interchange Program (CP/M) 


PPL 


Phase-Locked Loop 


PROM 


Programmable ROM 


PSW 


Program-Status Word 


R/W 


Read/Write 


RAM 


Random- Access Memory 


ROM 


Read-Only Memory 


RTS 


Request To Send 


SCR 


Silicon-Controlled Rectifier 


SID 


Symbolic Instruction Debugger (CP/M) 


TPA 


Transient Program Area (CP/M) 


TTL 


Transistor-Transistor Logic 


TTY 


Teletype 


UART 


Universal Asynchronous Receiver/Transmitter 


UJT 


Unijunction Transistor 


XOR 


Exclusive OR 



APPENDIX J 

Undocumented 
Z-80 Instructions 



The Z-80 CPU contains two 16-bit index registers called IX and lY. All of 
the official Zilog instructions which refer to IX and lY are 16-bit operations. 
For example, the IX register can be assigned the constant value 1234 with 
the LD instruction 

LD IXrl234H 

And the contents of the lY register can be saved on the stack with a PUSH 
operation. 

PUSH lY 

A perusal of the numerically ordered Z-80 instructions, given in Appendix F, 
reveals that sequences beginning with the byte DD hex refer to operations 
involving the IX register. Similarly, the byte FD hex signifies an lY operation. 

In addition to the 16-bit operations, there axe many 8-bit operations 
that can be performed with the Z-80 index registers. These instructions are 
not shown in Appendix F because they have not been officially documented 
by Zilog. All of these 8-bit IX and lY instructions follow the same pattern. 
The first byte of the IX operation codes is DD hex and the first byte of the 
lY operation codes is FD hex. The remaining byte of the instruction is a 
regular Z-80 operation which refers to the H or L register. But, in this case, 
H now refers to the high 8 bits of the index register and L refers to the low 
8 bits. 

As an example, consider the Z-80 instruction: 

LD Hfh 

which moves the byte in register B into the H register. If this operation code 
is preceded by a DD hex byte, then the B register is moved into the high 
8 bits of the IX register. An assembler that incorporated these undocumented 
instructions might generate the following source code. 



60 


LD 




JHOVE 


B 


TO 


H 


DD60 


LD 


XHrB 


5H0VE 


B 


TO 


HIGH IX 


DD6B 


LD 


XLfE 




E 


TO 


LOU IX 


Fn67 


LD 


YHf A 


»MOVE 


A 


TO 


HIBH lY 


FD69 


LD 


YLrC 




C 


TO 


LOW lY 
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But, except for Allen Ashley's PDS assembler, these XH, XL, YH, and YL 
symbols have not actually been incorporated into Z-80 assemblers. The 
undocumented instructions encompass all of the 8-bit LD op codes involv- 
ing the H and L registers. These include the register-to-register moves 

LD H»r 
LD L»r 
LD TfH 
LD r»L 

where r is one of the general-purpose registers A, B, C, D, and E. The in- 
structions 

LD LfH and 

LD HfL 

are also included. In this case the H and L refer respectively to the high 
8 bits and the low 8 bits of the same index register. Thus, the instruction 

LD L,H 

preceded by a DD byte will move the high 8 bits of the IX register into the 
low 8 bits. The regular H and L registers cannot be operands for these moves. 
Move-immediate instructions are not included in the new instructions. 
Furthermore, 8-bit transfers cannot be made from one index register to the 
other. 

Many of the other 8-bit register operations can be utilized in this way. 
In addition to the above LD instructions, these include the following. 



ADC 


AfH 


ADC 


A»L 


ADD 


A>H 


ADD 


AfL 


AND 


H 


AND 


L 


CP 


H 


CP 


L 


DEC 


H 


DEC 


L 


INC 


H 


INC 


L 


OR 


H 


OR 


L 


SBC 


ArH 


SBC 


A? L 


SUB 


H 


SUB 


L 


XOR 


H 


XOR 


L 



The rotations and shifts, the bit manipulations that set, reset and test, and 
the input and output operations are not included. 

All of these undocumented operations can be produced with a regular 
Z-80 assembler. One method is to generate the initial DD or FD hex with 
the DEFB directive. Then, the corresponding regular Z-80 instruction fol- 
lows. For example, the following two lines will generate the instruction 
needed to move the accumulator into the high half of IX. 

DEFB ODDH ?SET FOR IX 
LD HfA »MOyE A TO XH 
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Alternately, a macro can be used. The definition could be 



LDX MACRO REG1,REG2 

DEFB ODDH 
LD REG1»REG2 
ENDN 

Then the macro call 
LDX Hi-A 
will generate the desired code. 



Index 



Accumulator, 3 

Acoustical coupler, 65 

Acronyms, 311 

Active high, 93 

Analog-to-digital, 188 

Arithmetic shift, 76, 155, 180, 307 

ASCII, 20, 66, 150 

character set, 253 
Assembler, 2, 86 
Autostart tape, 201 

Base conversion, 150 
BCD, 19, 168 
Binary, 17 

Binary coded decimal, 19, 168 
BIOS (CP/M), 91, 216 
Block move, 13, 111, 297 
Branch table, 107 
Buffered input, 55 
Bus, 1 

Carry flag, 5,10 

Checksum, 68, 188 

Clock routine, 241 

Code, operation, 1 

Cold start, 103 

Compare 7, 123 

Complement, 21 

Concatination, 72 

Conditional branch, 12, 287, 293 

Control character, 93, 99, 100 

Conversion, number base, 150 

CP/M, 51, 86, 91, 123, 175, 201, 214 

CPU, 1 

Crazy octal, 164, 182 
Cross reference 

8080 to Z-80, 280 

Z-80 to 8080, 283 

DAA, 179 
Data port, 49 
Data ready, 91 
Debugger, 94 

Decimal adjust accumulator, 179 
Decrement, 8,10 



Delay, after carriage return, 148 

Delimiter, 151 

De Morgan's theorem, 28 

Digital-to-analog, 188 

Directive, 87 

DOS, 214 

Double precision arithmetic, 22, 180 
Double register, 3, 10, 13 
Doubling, 15, 155, 307 
Dummy variable, 70 
Dump, memory, 95 

Echo, 95 
Editor, 86, 143 
Exclusive OR, 26 

FCB (CP/M), 226, 242 
File control block, 226, 242 
Filename, 204 
Fixed entry, 152 
Flags, 3, 6, 10 

1/0,50,71,93 
Free entry, 152 
Full duplex, 65 
Function number (CP/M), 216 

Gates, 21 

GO program, 226 

Halving, 15 
Handshake, 49 
Hex arithmetic, 119 
Hex format, 201 
Hexadecimal numbers, 17 
High-level language, 2, 214 

Increment, 8, 10 
Index register, 313 
Input, 14, 48, 117, 146 
Instruction set 

alphabetic, 8080, 258 

alphabetic, Z-80, 264 

numeric, 8080, 261 

numeric, Z-80, 272 

details, 283 
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Intel hex format, 201 
Interrupt -driven keyboard, 55 
Interrupt register, 1 1 
Interrupts, 52 
lOBYTE (CP/M), 217, 220 

Jump, relative, 12, 144 

Label, 2 

local, 82 
Labels, readable, 203 
Leading-zero suppression, 173 
LIFO stack, 30 
List routine, 229 
Loader routine, 125 
Logical AND, 23, 224 
Logical devices, 215 
Logical exclusive OR, 26 
Logical operations, 7, 20 
Logical OR, 23 
Logical shift, 15 
Looping, 50 

Macros, 69, 143 
Magnetic tape, 187 
Masking AND, 25, 50, 178, 220 
Memory allocation (CP/M), 217 
Memory 
map, 255 

pointer, 2, 55, 113 

test, 120 
Memory-mapped port, 48 
Mnemonic, 2 
Modem, 64 
Monitor, 85, 128 
Movement of data. 111 
Multiplication, 15, 157 

NAND gate, 26 
Nibble, 178 
NOR gate, 26 
Nulls, carriage return, 

77, 93, 219 
Number-base conversion, 150 

Object program, 2 
Octal, 16, 163, 180 
Offset, 202 

One's complement, 21 

Opcode, 1 

Operand, 2 

Operation code, 1 

Output, 14, 48, 71, 117, 146, 215 

Packed BCD, 19, 168 
Page, memory, 105 
Paper tape, 187 
Parallel port, 49 
Parity, 66 
Passing data, 37, 39 
Peripheral, 1, 14 

port, 48, 117, 146 
Physical devices, 218 
PIP (CP/M), 143, 230 
Pointer, 2, 12, 55 



Polling, 52 
POP, 31 

Port, I/O, 48, 117, 146 

initialization, 146 
Printer routine, 147 
Program counter, 3, 11, 36 
Program status word, 3, 34 
PSW, 3, 34 
PUSH, 31 

Register 

flag, 3 

memory, 5 

refresh, 11 

saving, 33 

status, 2 
Register pair, 3 
Registers 

8080, 3 

Z-80, 11 
Relative jump, 12, 144 
Resetting a bit, 25 
Rotation, 9 
RST instruction, 53 

Scroll, 64, 99 
Searching, 113, 115 
Serial port, 49 
Setting a bit, 24 
Shift, 14, 76, 155, 307 
Signed number, 6, 15 
Source program, 2, 214 
Split octal, 164, 182 
Spooling, 52 
Stack, 30 

automatic placement, 45 

saving registers on, 33 

setting up new, 40 

storing data on, 31 
Stack pointer, 31, 109 
STAT (CP/M), 225 
Status port, 49 
String, 150 

Subroutine call, 35, 287 
Subtraction, 22, 177 

Table, command branch, 107 
Tape recording, 187 
Tape, test, 212 
Telephone modem, 64 
Top-down method, 85 
Truth table, 21 

Two's complement, 21, 74, 75, 177, 201 

Unconditional branch, 12 
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Warm start, 103 

Z-80 instruction macros, 73 
Z-80 registers, 11 
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